---
title: "Add subscribers to list"
method: POST
path: "/lists/{listId}/subscribers"
tags: ["Lists"]
---

# Add subscribers to list

`POST /lists/{listId}/subscribers`

Adds existing or new subscribers to one subscriber list from an email array. Use this endpoint without a `/bulk` suffix. Requires the lists:write and subscribers:write scopes.

## Path parameters

- `listId` string, required

## Request body

- object
  - `emails` string[], required — Up to 500 email addresses per request.
  - `duplicateStrategy` 'skip' | 'merge' | 'overwrite'
  - `enrollInSequences` boolean
  - `optInMode` 'default' | 'confirmed' | 'double_opt_in'

## Response `200`

Subscribers processed

- object
  - `success` boolean
  - `listId` string
  - `total` integer
  - `processed` integer
  - `created` integer
  - `updated` integer
  - `skipped` integer
  - `addedToList` integer
  - `failed` integer
  - `duplicateInputCount` integer
  - `ignoredBlankCount` integer
  - `results` object[]
    - `email` string
    - `success` boolean
    - `created` boolean
    - `updated` boolean
    - `skipped` boolean
    - `addedToList` boolean
    - `error` string

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — List not found
- `500` — Subscribers could not be added

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)