Merge Contacts

POST /contacts/v1/contact/merge-vids/:contact_id/

Method Details

HTTP Methods:

POST

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

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.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
 Contact ID Used in the request URL Unique identifier for a particular contact. In HubSpot's contact system, contact ID's are called "vid". 
 vidToMerge Used in the request body Unique identifier for a particular contact.