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

# Create Subscriber List

> Create a subscriber list

Create a subscriber list for grouping contacts.

## Request

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

<ParamField body="description" type="string">
  Optional list description.
</ParamField>

<ParamField body="isPrivate" type="boolean">
  Whether the list is internal/private.
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/lists" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "VIP Customers", "description": "High-value customers"}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "list": {
      "id": "list_abc123",
      "name": "VIP Customers",
      "description": "High-value customers",
      "isPrivate": false
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 500 theme={null}
  {
    "success": false,
    "error": "Failed to create list"
  }
  ```
</ResponseExample>