> ## 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.

# Create Newsfeed

> Create a new newsfeed with keywords.

# Create Newsfeed

<div className="method-badge post">POST</div> `/v1/newsfeeds`

## Request body

| Field              | Type      | Required | Description                                   |
| ------------------ | --------- | -------- | --------------------------------------------- |
| `name`             | string    | Yes      | Newsfeed name                                 |
| `keywords`         | string\[] | No       | Keywords to filter incoming posts             |
| `description`      | string    | No       | Description of the newsfeed                   |
| `business_context` | string    | No       | Business context for personalized AI insights |

```bash theme={null}
curl -X POST https://twixb.com/api/v1/newsfeeds \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Trends",
    "keywords": ["SEO", "growth hacking", "content marketing"],
    "description": "Track the latest marketing strategies",
    "business_context": "B2B SaaS startup selling developer tools"
  }'
```

## Response

Returns the created newsfeed object. See [List Newsfeeds](/api-reference/newsfeeds-list) for the full response schema.

```json theme={null}
{
  "id": "f296206d-d083-475d-a25a-711b044962d0",
  "name": "Marketing Trends",
  "keywords": ["SEO", "growth hacking", "content marketing"],
  "source_count": 0,
  "unread_count": 0,
  "role": "owner"
}
```

<Tip>
  Set `business_context` to get personalized key learnings in your posts. For example: "I run a B2B SaaS startup selling developer tools" will tailor AI insights to your specific situation.
</Tip>