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

# Add Subscribers To List

> Bulk add subscribers to a list

Add existing or new subscribers to one list from an email array. Send up to 500
email addresses per request. This is useful for temporary batch lists, imports,
and support workflows.

Use exactly `POST /api/v1/lists/{listId}/subscribers`. There is no `/bulk`
suffix for this endpoint.

Prefer this endpoint over looping one subscriber per request. Standard API rate
limits still apply: 100 requests per minute per API key and 20 requests per
second burst.

## Request

<ParamField path="listId" type="string" required>
  Subscriber list ID.
</ParamField>

<ParamField body="emails" type="string[]" required>
  Email addresses to add to the list. Maximum 500 per request.
</ParamField>

<ParamField body="duplicateStrategy" type="string" default="skip">
  Existing subscriber behavior: `skip`, `merge`, or `overwrite`.
</ParamField>

<ParamField body="enrollInSequences" type="boolean" default="false">
  Whether newly created subscribers should enter matching sequences.
</ParamField>

<ParamField body="optInMode" type="string" default="default">
  Consent mode for newly created subscribers: `default`, `confirmed`, or
  `double_opt_in`.
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/lists/list_abc123/subscribers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": ["one@example.com", "two@example.com"],
    "duplicateStrategy": "skip",
    "enrollInSequences": true
  }'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "listId": "list_abc123",
    "total": 2,
    "processed": 2,
    "created": 1,
    "updated": 1,
    "skipped": 0,
    "addedToList": 2,
    "failed": 0,
    "duplicateInputCount": 0,
    "ignoredBlankCount": 0,
    "results": [
      {
        "email": "one@example.com",
        "success": true,
        "created": false,
        "updated": false,
        "skipped": true,
        "addedToList": true
      }
    ]
  }
  ```

  ```json 400 theme={null}
  {
    "error": "Provide at least one non-empty email address."
  }
  ```

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

  ```json 404 theme={null}
  {
    "error": "List not found"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "Failed to add subscribers to list"
  }
  ```
</ResponseExample>