Skip to main content
POST
/
api
/
v1
/
subscribers
/
tags
Add Tag
curl --request POST \
  --url https://api.example.com/api/v1/subscribers/tags \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "tag": "<string>",
  "customAttributes": {}
}
'
{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "user@example.com",
    "tags": ["customer"],
    "created": false
  },
  "tag": {
    "id": "tag_xyz789",
    "name": "customer",
    "created": false
  }
}
Add a single tag to a subscriber. Creates the subscriber and/or tag if they don’t exist.

​
Request Body

​
email
string
required
Subscriber email address
​
tag
string
required
Tag name to add. Will be normalized (lowercase, hyphens).
​
customAttributes
object
Custom attributes to set on the subscriber (used when creating new subscriber)
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "tag": "customer"
  }'

​
Auto-Creation Behavior

This endpoint automatically creates resources if they don’t exist:
ResourceBehavior
SubscriberCreated with active status if email doesn’t exist
TagCreated and normalized if tag name doesn’t exist
This makes integration seamless—you don’t need to pre-create anything.

​
Tag Normalization

Tags are automatically normalized when added: 
"Pro Customer" → "pro-customer"
"VIP_User"     → "vip-user"
"Newsletter!"  → "newsletter"

​
Responses

{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "user@example.com",
    "tags": ["customer"],
    "created": false
  },
  "tag": {
    "id": "tag_xyz789",
    "name": "customer",
    "created": false
  }
}

​
Response Fields

FieldDescription
subscriber.createdtrue if subscriber was created by this request
tag.createdtrue if tag definition was created by this request

​
Use Cases

​
Track Customer Status

# When user purchases
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "buyer@example.com",
    "tag": "customer",
    "customAttributes": {
      "purchaseDate": "2024-01-15",
      "plan": "pro"
    }
  }'

​
Segment by Interest

# When user shows interest in a topic
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "reader@example.com",
    "tag": "interested-ai"
  }'
Adding a tag can trigger automations. If you have a sequence set to start when the tag is added, it will begin automatically.