Skip to main content
POST
Merge two contacts

Authorizations

Authorization
string
header
required

Your API key, e.g. sk_live_... or sk_test_....

Headers

Idempotency-Key
string

Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice.

Maximum string length: 255

Path Parameters

contact
string
required

The surviving contact's uuid.

Body

application/json
source
string
required

The contact to absorb, by uuid or phone number.

Response

Merged. Returns the surviving contact.

uuid
string
phone_number
string | null
bsuid
string | null

Business-scoped user id, when Meta gives one.

external_id
string | null
crm_id
string | null
identifiers
object[]
username
string | null
email
string | null
preferred_language
string | null
timezone
string | null
attributes
object
created_at
string<date-time> | null
updated_at
string<date-time> | null
identity
object