HUhubspot
Advanced

Merge two contacts

Changed on

Merge two contact records. Learn more about merging records.

post/crm/objects/2026-03/contacts/merge

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/contacts/merge
  • Auth
    none required

Request body

objectIdToMergestring required

The object ID of the record that the merge will not set as the current value after the merge.

primaryObjectIdstring required

The object ID of the record that the merge will generally set as the current value after the merge.

Response

successful operation

archivedboolean required

Whether the object is archived.

archivedAtstring date-time

The timestamp when the object was archived, in ISO 8601 format.

createdAtstring date-time required

The timestamp when the object was created, in ISO 8601 format.

idstring required

The unique ID of the object.

objectWriteTraceIdstring

An identifier used to trace the write request for the object. Set a unique ID for each write operation; it is returned with any errors so you can identify which request encountered which error.

propertiesobject required

Key-value pairs representing the properties of the object.

propertiesWithHistoryobject

Key-value pairs representing the properties of the object along with their history, each with a timestamp and source information.

updatedAtstring date-time required

The timestamp when the object was last updated, in ISO 8601 format.

urlstring

The URL associated with the object.

Changes