contacts

Merges a contact into a surviving contact. Both contacts must belong to the same account, unless the merged contact has no account, in which case it is first moved to the surviving contact's account. Issues, emails, phone numbers, survey responses, and other associated data are then transferred to the surviving contact, and the merged contact is permanently deleted. This cannot be undone.

Rate limit: 30 requests per minute

post/contacts/merge

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/contacts/merge
  • Auth
    HTTP bearer

Request body

merge_contact_idstring required

The ID of the contact to merge into the surviving contact. This contact is permanently deleted after its data is transferred.

merge_into_contact_idstring required

The ID of the contact that will survive the merge and receive the merged data. If the merged contact belongs to an account, this contact must belong to the same account.

Response

request_idstring required

The request ID for tracking.

Example response

{
  "data": {
    "custom_fields": {
      "role": {
        "value": "admin"
      }
    }
  }
}

Changes