Skip to main content
POST
/
api
/
v1
/
lists
/
{listId}
/
subscribers
Add Subscribers To List
curl --request POST \
  --url https://api.sequenzy.com/api/v1/lists/{listId}/subscribers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "<string>"
  ],
  "duplicateStrategy": "<string>",
  "enrollInSequences": true,
  "optInMode": "<string>"
}
'
{
  "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
    }
  ]
}
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

​
listId
string
required
Subscriber list ID.
​
emails
string[]
required
Email addresses to add to the list. Maximum 500 per request.
​
duplicateStrategy
string
default:"skip"
Existing subscriber behavior: skip, merge, or overwrite.
​
enrollInSequences
boolean
default:"false"
Whether newly created subscribers should enter matching sequences.
​
optInMode
string
default:"default"
Consent mode for newly created subscribers: default, confirmed, or double_opt_in.
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": false
  }'

​
Responses

{
  "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
    }
  ]
}