latestOpenAPI 3.0.2MIT2026-08-1745267541.8 KB

bdb3e0c48bf7

Contact

Get a Contact

Returns a specific contact as specified by the contact ID. Note the following:

If a WhatsApp contact is returned, the display_name field of that contact may be populated with the WhatsApp display name (if the name is already stored on the server and the display_name field has not been overwritten by the user).
If you receive an Inbound Message callback for an MO message on the Instagram channel, the corresponding payload will not include the Instagram username. You may use the contact_id and channel_identity values included in the callback to retreive the username (detailed in the display_name field) with this Conversation API operation.

get/v1/projects/{project_id}/contacts/{contact_id}

Response

A successful response.

channel_priorityConversationChannel[]

List of channels defining the channel priority.

display_namestring

The display name. A default 'Unknown' will be assigned if left empty.

emailstring

Email of the contact.

external_idstring

Contact identifier in an external system.

idstring

The ID of the contact.

language'AF' | 'SQ' | 'AR' | 'AZ' | 'BN' | 'BG' | 'CA' | 'ZH' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'HR' | 'CS' | 'DA' | 'NL' | 'EN' | 'EN_GB' | 'EN_US' | 'ET' | 'FIL' | 'FI' | 'FR' | 'DE' | 'EL' | 'GU' | 'HA' | 'HE' | 'HI' | 'HU' | 'ID' | 'GA' | 'IT' | 'JA' | 'KN' | 'KK' | 'KO' | 'LO' | 'LV' | 'LT' | 'MK' | 'MS' | 'ML' | 'MR' | 'NB' | 'FA' | 'PL' | 'PT' | 'PT_BR' | 'PT_PT' | 'PA' | 'RO' | 'RU' | 'SR' | 'SK' | 'SL' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'SW' | 'SV' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZU'

metadatastring

Metadata associated with the contact. Up to 1024 characters long.

Example response

{
  "channel_identities": [
    {
      "channel": "WHATSAPP"
    }
  ],
  "channel_priority": [
    "WHATSAPP"
  ],
  "id": "{CONTACT_ID}"
}