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

# Create List

> Create an empty list

Creates the list. Add members afterward with [Add Companies To
List](/api-reference/add-companies-to-list) or [Add People To
List](/api-reference/add-people-to-list).

## Body

<ParamField body="name" type="string" required />

<ParamField body="entity_type" type="string" required>
  `people` or `accounts`.
</ParamField>

<ParamField body="description" type="string" />

<ParamField body="color" type="string" />

<ParamField body="list_kind" type="string" default="membership">
  `membership` (a static, hand-picked set) or `filter` (a saved query).
  Membership is what you want for "these specific ones" — see
  [Lists](/lists).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.clustr-ai.com/api/public/lists" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Q3 target accounts", "entity_type": "accounts"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "data": { "message": "List created successfully" }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": { "message": "entity_type must be one of people, accounts", "code": "BAD_REQUEST" }
  }
  ```
</ResponseExample>