younifyd
Menu

Post /crm/v3/objects/contacts/merge Merge

Merge two contacts

POST/crm/v3/objects/contacts/merge

Use it in a workflow

  1. Add a step and choose the HubSpot connector.
  2. Pick the Post /crm/v3/objects/contacts/merge Merge action (under Contacts).
  3. Fill in the fields below, then reference the result from later steps as {{postCrmV3ObjectsContactsMergeMerge.response.data}}.

Request

Request body

Enter the body as JSON in the step's Body field.

objectIdToMergestringrequired

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

primaryObjectIdstringrequired

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

json
{
  "objectIdToMerge": "string",
  "primaryObjectId": "string"
}

Response

Returns 200 with an object. Read it in later steps with {{postCrmV3ObjectsContactsMergeMerge.response.data.<field>}}.

archivedboolean

Whether the object is archived.

archivedAtstring (date-time)

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

createdAtstring (date-time)

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

idstring

The unique ID of the object.

objectWriteTraceIdstring

An identifier used for tracing the write request for the object.

propertiesobject

Key-value pairs representing the properties of the object.

propertiesWithHistoryobject

Key-value pairs representing the properties of the object along with their history.

updatedAtstring (date-time)

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

urlstring

The URL associated with the object.

warningsarray<object>
categorystringrequired
contextobjectrequired
messagestringrequired
json
{
  "archived": false,
  "createdAt": "2025-01-01T00:00:00Z",
  "id": "string",
  "properties": {},
  "updatedAt": "2025-01-01T00:00:00Z",
  "archivedAt": "2025-01-01T00:00:00Z",
  "objectWriteTraceId": "string",
  "propertiesWithHistory": {},
  "url": "string",
  "warnings": [
    {
      "category": "string",
      "context": {},
      "message": "string"
    }
  ]
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.