There's a new version of the HubSpot API

Starting November 30, 2022, API keys will be sunset as an authentication method. Learn more about this change and how to migrate an API key integration to use a private app instead.

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.