Front API

Getting access, Developing, Testing

Back to Front

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

Input

type: object properties: data: type: object properties: contact_ids: type: array items: type: string target_contact_id: type: string title: Data

Output

type: object properties: _links: type: object properties: self: type: string related: type: object properties: notes: type: string conversations: type: string owner: type: string id: type: string name: type: string description: type: string avatar_url: type: string is_spammer: type: boolean links: type: array items: type: string groups: type: array items: type: object properties: _links: type: object properties: self: type: string related: type: object properties: contacts: type: string owner: type: string id: type: string name: type: string is_private: type: boolean handles: type: array items: type: object properties: handle: type: string source: type: string custom_fields: type: object properties: {} is_private: type: boolean