Skip to main content
POST
Create or update a contact

Authorizations

Authorization
string
header
required

An API key from the dashboard. sk_live_… sends; sk_test_… validates and returns ids without sending.

Body

application/json

One of email or phone is required.

email
string<email>
phone
string

E.164

attributes
object

Your own flat fields, up to 40 keys of lower-case letters, digits and underscores; values up to 500 characters. first_name fills {{first_name}} in sends.

Example:

Response

Updated

id
string
required
Example:

"ct_01j9x7k2r4m8q3v5n6b7c8d9e0"

email
string | null
required
phone
string | null
required
attributes
object
required

Your own flat fields, up to 40 keys of lower-case letters, digits and underscores; values up to 500 characters. first_name fills {{first_name}} in sends.

Example:
marketing
object
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
consents
object[]
required

Every consent record, newest first, revoked ones included.