Skip to main content
POST
Look up a contact by email

Look up by email

POST /contacts/lookup
The response is 200 OK with data: null when no active contact exists.

Upsert by email

POST /contacts/upsert
Upsert merges provided fields, validates declared audience properties, and returns the contact with created: true or created: false. Email is normalized per project and concurrent requests resolve to one active contact.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
email
string<email>
required

Response

Contact or null

status
number
data
unknown
error
unknown
metadata
unknown