Contacts

Merge Contacts

Merge two contacts into a single contact. The base contact remains and receives all data from the mergee contact. After the merge, the mergee contact is permanently deleted.

This action is irreversible. All conversations, labels, and custom attributes from the mergee contact will be moved to the base contact.

post/v1/workspaces/{workspace_id}/actions/contact_merge

Request

  • Base URL: https://api.oxvo.com
  • URL: https://api.oxvo.com/v1/workspaces/{workspace_id}/actions/contact_merge
  • Auth: API key in header api_access_token

Request body

base_contact_idinteger required

ID of the contact that will remain after the merge and receive all data

mergee_contact_idinteger required

ID of the contact that will be merged into the base contact and deleted

Example request

{
  "base_contact_id": 1,
  "mergee_contact_id": 2
}

Response

Contacts merged successfully

idnumber

Example response

{
  "payload": [
    {
      "custom_attributes": {
        "attribute_key": "attribute_value",
        "signed_up_at": "dd/mm/yyyy"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.