HUhubspot
Advanced

Merge two companies

Changed on

Merge two company records. Learn more about merging records.

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/objects/2026-03/companies/merge
  • Auth
    • HTTP bearer
    • or API key in query parameter hapikey
    • or none

Request body

objectIdToMergestring required

The ID of the company to merge into the primary.

primaryObjectIdstring required

The ID of the primary company, which the other will merge into.

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 for tracing the write request for the object.

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.

updatedAtstring date-time required

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

urlstring

The URL associated with the object.

Changes

  • b0d8bc008db9Revision changes
    • info

      api operation id post-/crm/objects/2026-03/companies/merge_merge removed and replaced with post-/crm/objects/2026-03/companies/merge

  • dc2fdad57f7fRevision changes
    • info

      api operation id post-/crm/objects/2026-03/companies/merge_/crm/objects/2026-03/companies/merge removed and replaced with post-/crm/objects/2026-03/companies/merge_merge

Some revisions have not been checked yet.