Skip to main content
POST
/
api
/
v1
/
subscribers
/
tags
/
remove
Remove Tag
curl --request POST \
  --url https://api.sequenzy.com/api/v1/subscribers/tags/remove \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "externalId": "<string>",
  "tag": "<string>",
  "firstName": "<string>",
  "lastName": "<string>"
}
'
{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "user@example.com",
    "externalId": "user_123",
    "tags": ["newsletter"],
    "created": false
  },
  "tag": {
    "name": "premium",
    "removed": true
  }
}
Remove a tag from a subscriber. If the subscriber doesn’t exist, they will be created (without the tag).

​
Request Body

​
email
string
Subscriber delivery email address. Required when creating a new subscriber.
​
externalId
string
Your app/customer/user ID for this subscriber. You can remove tags with only externalId when the subscriber already exists.
​
tag
string
required
Tag name to remove
​
firstName
string
First name (used if creating new subscriber)
​
lastName
string
Last name (used if creating new subscriber)
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags/remove" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "externalId": "user_123",
    "tag": "premium"
  }'

​
Responses

{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "user@example.com",
    "externalId": "user_123",
    "tags": ["newsletter"],
    "created": false
  },
  "tag": {
    "name": "premium",
    "removed": true
  }
}

​
Response Fields

FieldDescription
subscriber.createdtrue if subscriber was created by this request
tag.removedtrue if the tag was removed from the subscriber

​
Use Cases

​
Downgrade Customer Status

# When customer cancels subscription
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags/remove" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "tag": "premium"
  }'

​
Remove Interest Tag

# When user unsubscribes from a topic
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags/remove" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "reader@example.com",
    "tag": "interested-ai"
  }'
If the subscriber doesn’t have the specified tag, the request will still succeed with tag.removed: false.