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

> Save a post to a reading list.

# Add to List

<div className="method-badge post">POST</div> `/v1/lists/{list_id}/items`

## Path parameters

| Parameter | Type          | Description |
| --------- | ------------- | ----------- |
| `list_id` | string (UUID) | List ID     |

## Request body

| Field     | Type          | Required | Description    |
| --------- | ------------- | -------- | -------------- |
| `post_id` | string (UUID) | Yes      | Post ID to add |

```bash theme={null}
curl -X POST https://twixb.com/api/v1/lists/5593f707-.../items \
  -H "X-API-Key: twxb_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"post_id": "a6afb505-640c-4daf-a27d-d9b6b1eb2a83"}'
```

## Response

Returns the created list item.