v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-02172186551.1 KB

Merge contacts

Merge a source contact into this contact. All channels from the source contact will be moved to the target contact, and the source contact will be marked as merged.

post/v1/contacts/{contactId}/merge

Path parameters

contactIdstring required

Request body

sourceContactIdstring required

ID of the contact to merge into the target contact. The source contact will be marked as merged.

Response

Contacts merged. Returns the updated target contact.

idstring required

displayNamestring

Display name for the contact.

phoneNumberstring

DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.

primaryPhonestring

Primary phone number in E.164 format.

primaryEmailstring email

Primary email address.

countryCodestring

profileNamestring nullable

Contact's WhatsApp profile name. Only available for WhatsApp contacts.

availableChannelsstring[] required

List of available messaging channels for this contact.

Preferred channel for this contact.

verifiedboolean required

Whether this contact has been verified.

suggestedMergeWithstring

ID of a contact suggested for merging.

metadataobject required

createdAtstring date-time required

updatedAtstring date-time

Example response

{
  "displayName": "John Doe",
  "phoneNumber": "+56912345678",
  "primaryPhone": "+56912345678",
  "primaryEmail": "john@example.com",
  "countryCode": "CL",
  "profileName": "John Doe",
  "channels": [
    {
      "identifier": "+14155551234",
      "countryCode": "US",
      "label": "work"
    }
  ]
}