Skip to main content
POST
/
api
/
v1
/
lists
/
{listId}
/
subscribers
/
remove
Remove Subscribers from List
curl --request POST \
  --url https://api.sequenzy.com/api/v1/lists/{listId}/subscribers/remove \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "emails": [
    "<string>"
  ],
  "subscriberIds": [
    "<string>"
  ]
}
'
{
  "success": true,
  "removed": 1,
  "notFound": ["unknown@example.com"]
}
Remove subscribers from one list by email or subscriber ID. Subscribers are not deleted, they only lose the list membership. You can pass up to 500 targets per request, combined across emails and subscriberIds.

​
Request

​
listId
string
required
Subscriber list ID.
​
emails
string[]
Email addresses to remove. Emails are trimmed and lowercased. Unknown emails are returned in notFound.
​
subscriberIds
string[]
Subscriber IDs to remove.
Provide at least one of emails or subscriberIds. 
curl -X POST "https://api.sequenzy.com/api/v1/lists/list_abc123/subscribers/remove" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails": ["user@example.com", "unknown@example.com"]}'

​
Responses

{
  "success": true,
  "removed": 1,
  "notFound": ["unknown@example.com"]
}