> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twixb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Source

> Add a content source to a newsfeed.

# Add Source

<div className="method-badge post">POST</div> `/v1/sources/{newsfeed_id}`

Add a blog, X/Twitter profile, Instagram profile, TikTok profile, or Reddit subreddit as a source.

## Path parameters

| Parameter     | Type          | Description |
| ------------- | ------------- | ----------- |
| `newsfeed_id` | string (UUID) | Newsfeed ID |

## Request body

| Field | Type   | Required | Description |
| ----- | ------ | -------- | ----------- |
| `url` | string | Yes      | Source URL  |

Supported URL formats:

* **Blogs**: Any website URL (RSS auto-discovered)
* **X/Twitter**: `https://x.com/username`
* **Instagram**: `https://instagram.com/username`
* **TikTok**: `https://tiktok.com/@username`
* **Reddit**: `https://reddit.com/r/subreddit`

```bash theme={null}
curl -X POST https://twixb.com/api/v1/sources/f296206d-... \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://openai.com/blog"}'
```

## Response

Returns the created source object. See [List Sources](/api-reference/sources-list) for the full response schema.

<Tip>
  Use [Validate Source](/api-reference/sources-validate) first to check if a URL is crawlable and see discovered RSS feeds.
</Tip>