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

> Create a new reading list.

# Create List

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

## Request body

| Field         | Type   | Required | Description |
| ------------- | ------ | -------- | ----------- |
| `name`        | string | Yes      | List name   |
| `description` | string | No       | Description |

```bash theme={null}
curl -X POST https://twixb.com/api/v1/lists \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"name": "Weekly Highlights", "description": "Best posts of the week"}'
```

## Response

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