Skip to main content
POST
/
api
/
v1
/
subscribers
{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "status": "active",
    "tags": ["newsletter"],
    "customAttributes": { "plan": "pro" },
    "createdAt": "2024-01-15T10:30:00Z"
  }
}
Create a new subscriber. Returns 409 if the subscriber already exists.

​
Request Body

​
email
string
required
Subscriber email address
​
firstName
string
First name
​
lastName
string
Last name
​
status
string
default:"active"
Status: active or unsubscribed
​
tags
string[]
Array of tag names to assign
​
customAttributes
object
Custom key-value attributes
curl -X POST "https://api.sequenzy.com/api/v1/subscribers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "tags": ["newsletter"],
    "customAttributes": { "plan": "pro" }
  }'

​
Responses

{
  "success": true,
  "subscriber": {
    "id": "sub_abc123",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "status": "active",
    "tags": ["newsletter"],
    "customAttributes": { "plan": "pro" },
    "createdAt": "2024-01-15T10:30:00Z"
  }
}