Merge contacts

Merges the contacts specified into a single contact, deleting the merged-in contacts. If a target contact ID is supplied, the other contacts will be merged into that one. Otherwise, some contact in the contact ID list will be treated as the target contact. Merge conflicts will be resolved in the following ways:

  • name will prioritize manually-updated and non-private contact names
  • descriptions will be concatenated and separated by newlines in order from oldest to newest with the (optional) target contact's description first
  • all handles, groups, links, and notes will be preserved
  • other conflicts will use the most recently updated contact's value

Required scope: contacts:write

Body Params
string

Optional contact ID to merge the other contacts into.

contact_ids
array of strings
required

Array of all the contact IDs of the contacts to be merged. If a target contact id is provided and that contact id is not in this array, the length of this array must be between 1 and 49. If no target contact id is provided or it is contained in this array, the length must be between 2 and 50.

contact_ids*
Response

Language
Credentials
Bearer
JWT
Response
Choose an example:
application/json