{
"email": "sarah@domain.com",
"name": "Sarah W",
"phone": "+1 987 654 3210",
"company": "Tech Innovations",
"job_title": "Product Manager",
"linkedin_url": "https://linkedin.com/in/sarahw",
"list_id": "list-1234",
"is_subscribed": true,
"additional_info": {
"industry": "SaaS",
"tier": "Premium"
}
}
{
"success": true,
"data": {
"id": "88de-12bc",
"email": "sarah@domain.com"
},
"message": "Subscriber created and synchronized successfully."
}
Audience & Lists
Upsert Contact
Create or update profile with custom metadata and list associations.
POST
/
subscribers
{
"email": "sarah@domain.com",
"name": "Sarah W",
"phone": "+1 987 654 3210",
"company": "Tech Innovations",
"job_title": "Product Manager",
"linkedin_url": "https://linkedin.com/in/sarahw",
"list_id": "list-1234",
"is_subscribed": true,
"additional_info": {
"industry": "SaaS",
"tier": "Premium"
}
}
{
"success": true,
"data": {
"id": "88de-12bc",
"email": "sarah@domain.com"
},
"message": "Subscriber created and synchronized successfully."
}
Request Body
string
required
Primary key (email)
string
Full name
string
Optional: Target list ID to associate the contact with.
string
Optional: Phone number
string
Optional: Company name
string
Optional: Job title
string
Optional: LinkedIn profile URL
array
Optional: List of tags to apply.
boolean
Optional: Subscription status (default: true)
object
Key-value pair metadata (Merge Tags)
{
"email": "sarah@domain.com",
"name": "Sarah W",
"phone": "+1 987 654 3210",
"company": "Tech Innovations",
"job_title": "Product Manager",
"linkedin_url": "https://linkedin.com/in/sarahw",
"list_id": "list-1234",
"is_subscribed": true,
"additional_info": {
"industry": "SaaS",
"tier": "Premium"
}
}
{
"success": true,
"data": {
"id": "88de-12bc",
"email": "sarah@domain.com"
},
"message": "Subscriber created and synchronized successfully."
}