Contacts

Merges the contact source_contact_id into the contact in the path. This is irreversible, like deleting a contact: the source contact is deleted, the kept contact's empty fields are filled from it, its notes are appended, its sequences, tasks, tags, audience memberships, opportunity links, custom field values move to the kept contact, and its live sequences are stopped.

When live sequences would be stopped the request is rejected with 409 sequence_stop_confirmation_required unless confirm_sequence_stop is true. The merge runs in one transaction: on 422 merge_failed nothing was changed. Retrying a merge that already completed returns 404, because the source contact no longer exists.

post/v1/contacts/{contact_id}/merge

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/contacts/{contact_id}/merge
  • Auth
    none declared

Path parameters

contact_idstring uuid required

Request body

source_contact_idstring uuid required

ID of the contact to merge into the contact in the path. It is deleted when the merge is applied. Both contacts must be on the same account.

confirm_sequence_stopboolean

Confirms that the live sequences listed under blocking_sequences in the preview may be stopped. Without it, a merge that would stop live sequences is rejected with sequence_stop_confirmation_required.

Response

Successful Response

Changes