# Create a Feed

Capture posts from social sources once and reuse them for podcasts, schedules, and social reposts inside AutoContent.

## Before You Begin

* Add your API key in `Settings`; the Feeds pages stay locked until authentication succeeds.
* Decide which network you need: X (Twitter) or Reddit are available today. Each account can hold up to four feeds.
* Keep the source identifiers handy (Twitter username without `@`, subreddit without `r/`).

## Step 1: Open the Feeds Dashboard

1. In the sidebar, go to `Feeds`.
2. Review any existing feeds grouped by source. Each card shows the most recent refresh time and shortcuts to the original account or subreddit.
3. Click `Create Feed` to launch the builder at `/feeds/create`.

## Step 2: Fill Out Feed Details

The form mirrors the publishing requirements enforced by the API:

| Field      | Required | Notes                                                                                                           |
| ---------- | -------- | --------------------------------------------------------------------------------------------------------------- |
| Feed Name  | Yes      | Friendly label that appears in episode and scheduler pickers.                                                   |
| Feed Type  | Yes      | Choose `X/Twitter` or `Reddit`. Only one type per feed.                                                         |
| Identifier | Yes      | Twitter username without `@`, or subreddit name without `r/`. The form strips accidental symbols automatically. |

Cards highlight the differences between source types. Use the helper text under each field if you forget the exact format.

## Step 3: Create the Feed

Select `Create Feed`. The button locks while the API runs and the success banner reveals the new `Feed ID`. You will also see the feed under the relevant section back on the dashboard.

Need the raw request for automation? Toggle `Show API Request` to view the exact payload the UI sends:

```bash
curl -X POST "https://api.autocontentapi.com/feeds" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News from Elon Musk",
    "feedTypeId": 1,
    "internalId": "elonmusk"
  }'
```

On success the API responds with:

```json
{
  "success": true,
  "feedId": 42,
  "message": "Feed created successfully"
}
```

## Step 4: Manage Feeds from the Dashboard

The `Feeds` page is your control center:

* **View source:** `View Source` opens the original account or subreddit in a new tab.
* **Check freshness:** Each card shows the last update timestamp and relative age (for example, `12m ago`).
* **Delete feed:** Use the `X` button on a card to remove a feed (confirmation required). Remember that each workspace can only keep four feeds at a time.
* **Empty state:** If you clear every feed, you will get a guided prompt to create a new one.

## Step 5: Generate Podcasts from Feeds

Feeds become selectable across creation tools:

* In `Podcasts -> Episodes -> New Episode`, choose the `Use Feeds` card, pick one or more feeds, and finish the request. That selection reuses the same flow documented in [Create a Podcast Episode from an X Feed](/quick-start/podcasts/create-feed-podcast.md).
* In the Scheduler, switch `Input Mode` to `Feeds` to automate recurring drops based on your saved sources.
* When episode generation finishes, attach it to a show via [Create a Podcast Show](/quick-start/podcasts/create-podcast-show.md) so the RSS feed updates automatically.

## Step 6: Reuse Feeds Elsewhere

Beyond podcasts, your saved feeds appear inside recurring X posts and other automations. Because all tools reference the same list, keeping feeds updated in the dashboard keeps every workflow in sync.

## Related Endpoints

* `POST /feeds` – Create a new feed.
* `GET /feeds` – List all feeds available to the account.
* `POST /feeds/delete` – Remove a feed by ID.

## What's Next?

* Turn a feed into audio using [Create a Podcast Episode from an X Feed](/quick-start/podcasts/create-feed-podcast.md).
* Schedule those episodes for release with the [Scheduler](/quick-start/podcasts/set-duration.md).
* Mix feeds with other sources when building a show via [Create a Podcast Episode](/quick-start/podcasts/create-podcast-episode.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.autocontentapi.com/quick-start/podcasts/create-feed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.