Skip to main content
POST
/
api
/
v1
/
subscribers
/
tags
/
bulk
{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "[email protected]",
    "tags": ["customer", "newsletter", "pro-plan"],
    "created": false
  },
  "tags": {
    "added": ["customer", "newsletter", "pro-plan"],
    "created": ["pro-plan"]
  }
}
Add multiple tags to a subscriber in one request. Creates the subscriber and/or tags if they don’t exist.

​
Request Body

​
email
string
required
Subscriber email address
​
tags
string[]
required
Array of tag names to add
​
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/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "tags": ["customer", "newsletter", "pro-plan"]
  }'

​
Auto-Creation Behavior

This endpoint automatically creates resources if they don’t exist:
ResourceBehavior
SubscriberCreated with active status if email doesn’t exist
TagsEach tag created and normalized if it doesn’t exist

​
Responses

{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "[email protected]",
    "tags": ["customer", "newsletter", "pro-plan"],
    "created": false
  },
  "tags": {
    "added": ["customer", "newsletter", "pro-plan"],
    "created": ["pro-plan"]
  }
}

​
Response Fields

FieldDescription
subscriber.createdtrue if subscriber was created by this request
tags.addedAll tags now on the subscriber from this request
tags.createdTags that were newly created (didn’t exist before)

​
Use Cases

​
New Customer Onboarding

# Tag with multiple attributes at once
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "tags": ["customer", "onboarding", "2024-cohort", "source-organic"],
    "customAttributes": {
      "plan": "pro",
      "signupDate": "2024-01-15"
    }
  }'

​
Update Segments

# Batch update subscriber segments
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/tags/bulk" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "tags": ["enterprise", "high-value", "priority-support"]
  }'
Tags are normalized (lowercase, hyphens) before being added. The tags.created array shows which tag definitions were newly created by this request.