There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.

Merge Contacts

Last updated June 17, 2020

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

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


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.