Skip to main content
POST
Merge objects

Supported products

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

objectType
string
required

The type of the CRM object to be merged, such as contacts, companies, or deals.

Body

application/json

Input data for merging two records.

objectIdToMerge
string
required

The unique identifier of the object that will be merged into the primary object. This is a string.

primaryObjectId
string
required

The unique identifier of the primary object that will remain after the merge. This is a string.

Response

successful operation

A simple public object.

archived
boolean
required

A boolean indicating whether this object is archived.

createdAt
string<date-time>
required

The date and time when this object was created, in ISO 8601 format.

id
string
required

The unique identifier for this object, represented as a string.

properties
object
required

A map of property names to their corresponding values, where each value is a string.

updatedAt
string<date-time>
required

The date and time when this object was last updated, in ISO 8601 format.

archivedAt
string<date-time>

The date and time when this object was archived, in ISO 8601 format.

objectWriteTraceId
string

A string used to trace the write operations for this object.

propertiesWithHistory
object

A map of property names to arrays of values with timestamps, showing the history of changes for each property.

url
string

A string representing the URL associated with this object.

warnings
object[]

An array of warnings related to this object, each containing a category, message, and context.

Last modified on September 14, 2026