Skip to main content
POST
Create a contact

How an existing contact is reused

  • With external_id: the contact is matched by that ID alone. If a contact with the same external_id exists, it is updated with the fields you send and its id is returned. Email and phone never match it to another contact.
  • Without external_id: an existing contact with the same email, or else the same phone number, is updated and returned.
Send primary_external_id to link the contact to a main account, or null to unlink a matched contact. It cannot equal external_id. See Link accounts to a main contact.

Authorizations

Authorization
string
header
required

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

Body

application/json
contact
object
required

Response

Default Response

id
string<uuid>
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$