Skip to main content
POST
Create a contact
Create a single contact. If double_opt_in is provided the contact is created in unverified status and receives a confirmation email — they become subscribed only after clicking the confirmation link. Requires the audience:write scope and is blocked for sandbox API keys.

Authorizations

Authorization
string
header
required

API key for authentication

Body

application/json

Request to create a single contact

email
string<email>
required
Maximum string length: 255
Example:

"jane@example.com"

list_id
string<uuid> | null

Optional list to add the contact to

properties
object | null

Custom property values. Each key must match a property defined for the team.

Example:
double_opt_in
object

Double opt-in configuration. When provided, the contact receives a confirmation email and is created in unverified status until they click the confirmation link.

Response

Contact created

message
string
required
Example:

"Contact retrieved successfully."

data
object
required

Audience contact