Skip to main content
POST
Bulk create contacts
Create up to 1000 contacts in a single request. Emails are normalized and deduplicated; contacts that already exist are reported in already_existed. Requires the audience:write scope and is blocked for sandbox API keys.

Authorizations

Authorization
string
header
required

API key for authentication

Body

application/json

Bulk create contacts. Emails are normalized (lowercased, trimmed) and deduplicated.

emails
string<email>[]
required
Required array length: 1 - 1000 elements
Maximum string length: 255
Example:
list_id
string<uuid> | null

Optional list to add all contacts to

properties
object | null

Custom property values applied to every contact created in this batch

Response

Contacts created

message
string
required
Example:

"Contacts created successfully."

data
object
required