Skip to main content
POST
Create or update contacts

Authorizations

Authorization
string
header
required

Your API key (as_live_…), created under Settings → API keys.

Body

application/json
contacts
object[]
list
string
list_id
string

Response

Result of the upsert.

ok
boolean
Example:

true

imported
integer

Contacts created or updated.

Example:

2

skipped
integer

Rows skipped (e.g. invalid phone).

Example:

0

list_id
string | null

The list they were added to, if list/list_id was given.

Example:

"8f3c2b10-..."

contact_ids
string[]

Ids of the affected contacts.