Companies

Merge Company

Merge secondary_id INTO this company. THE SECONDARY STOPS EXISTING.

Its contacts, deals and activity move onto the survivor. Undo is one merge at a time through POST /duplicates/undo-merge/{merge_history_id}. Preview first. 409 when a blocker refuses the merge.

post/companies/{company_id}/merge

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/companies/{company_id}/merge
  • Auth: HTTP bearer

Path parameters

company_idinteger required

The company that SURVIVES the merge.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

secondary_idinteger required

The record merged AWAY.

suggestion_idstring nullable

The duplicate suggestion this merge acts on, if any.

trigger'manual' | 'bulk_criterion'

What prompted the merge. Recorded on the audit row.

bulk_criterionstring nullable

The bulk criterion, when trigger is bulk_criterion.

Response

Successful Response

dataCrmRecordPayload required

An open envelope for one record, one dashboard or one job receipt.

Open because most of these reads are COMPUTED shapes - an engagement summary, a next-best-step, an intelligence status - that grow with the product, and dropping a field from an advisory read makes it say "nothing to report" rather than "we did not tell you".

Changes

No recorded changes to this operation across all 2 revisions of this API.