Merge contacts

curl --request POST \
  --url https://api.hubapi.com/contacts/v1/contact/merge-vids/{contact_id}/ \
  --header 'Content-Type: application/json' \
  --data '{
  "vidToMerge": "<string>"
}'

"\nExample POST URL:\nhttps://api.hubapi.com/contacts/v1/contact/merge-vids/1343724/\n\nExample POST data:\n{\n  \"vidToMerge\": 1343774\n}\n\nReturns a 200 OK response on success\nwith the text SUCCESS as the response body.\n\nOtherwise, you'll get an error response, with a\nmessage in the response body giving more details about\nthe error."

Contacts

Merge contacts

Merge two contact records. The contact ID in the URL will be treated as the primary contact, and the contact ID in the request body will be treated as the secondary contact. For more details about what happens when you merge two contact records, please see this knowledge article. Note: Merging contacts cannot be undone. The data from the secondary contact will be merged into the primary contact, and while you can see the combined history of the two records in the resulting single contact, there is not a way to separate the contacts after the merge.

POST

contacts

contact

merge-vids

{contact_id}

Merge contacts

curl --request POST \
  --url https://api.hubapi.com/contacts/v1/contact/merge-vids/{contact_id}/ \
  --header 'Content-Type: application/json' \
  --data '{
  "vidToMerge": "<string>"
}'

"\nExample POST URL:\nhttps://api.hubapi.com/contacts/v1/contact/merge-vids/1343724/\n\nExample POST data:\n{\n  \"vidToMerge\": 1343774\n}\n\nReturns a 200 OK response on success\nwith the text SUCCESS as the response body.\n\nOtherwise, you'll get an error response, with a\nmessage in the response body giving more details about\nthe error."

Path Parameters

contact_id

string

required

Unique identifier for a particular contact. In HubSpot's contact system, contact ID's are called "vid".

Body

application/json

Response

200 - application/json

Successful response - Merge two contact records

The response is of type object.

Create or update a contact by email

Create a new contact

Analytics and Events

Automation

CMS

CRM

Settings

OAuth

Marketing

Merge contacts

Path Parameters

Body

Response