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

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 existing or new subscribers to one list from an email array. Send up to 100 email addresses per request. This is useful for temporary batch lists, imports, and support workflows.

​
Request

​
listId
string
required
Subscriber list ID.
​
emails
string[]
required
Email addresses to add to the list. Maximum 100 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
    }
  ]
}