# 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](https://docs.autocontentapi.com/quick-start/podcasts/create-feed-podcast).
* 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](https://docs.autocontentapi.com/quick-start/podcasts/create-podcast-show) 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](https://docs.autocontentapi.com/quick-start/podcasts/create-feed-podcast).
* Schedule those episodes for release with the [Scheduler](https://docs.autocontentapi.com/quick-start/podcasts/set-duration).
* Mix feeds with other sources when building a show via [Create a Podcast Episode](https://docs.autocontentapi.com/quick-start/podcasts/create-podcast-episode).