younifyd
Menu

Merge Contact

Merge a lead and a user

POST/contacts/merge

Use it in a workflow

  1. Add a step and choose the Intercom connector.
  2. Pick the Merge Contact action (under Contacts).
  3. Fill in the fields below, then reference the result from later steps as {{mergeContact.response.data}}.

Request

Query parameters

include_merge_historyboolean

Pass `true` to include the merge history of the resulting contact in the response. Only returned for contacts with a `user` role.

Default false

Headers

Intercom-Versionstring

Intercom API version.</br>By default, it's equal to the version set in the app package.

One of1.01.11.21.31.42.02.12.22.32.42.52.62.72.82.92.102.112.122.132.142.152.16Default "2.16"

Request body

Enter the body as JSON in the step's Body field.

fromstringrequired

The unique identifier for the contact to merge away from. Must be a lead.

intostringrequired

The unique identifier for the contact to merge into. Must be a user.

skip_duplicate_validationboolean

Set to `true` to merge two contacts that are not duplicates (they share no matching email or phone).

json
{
  "from": "5d70dd30de4efd54f42fd526",
  "into": "5ba682d23d7cf92bef87bfd4",
  "skip_duplicate_validation": true
}

Response

Returns 200 with an object. Read it in later steps with {{mergeContact.response.data.<field>}}.

enabled_push_messagingboolean

If the user has enabled push messaging.

json
{
  "enabled_push_messaging": true
}

Need more? See the Intercom guide for connection setup and behaviour shared by every action.