v19

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-017489931.2 KB

Merge two opportunities

Merges two opportunities into one. The primary opportunity retains its ID; the duplicate is soft-deleted. Both opportunities must belong to the same account.

Required scopes: opportunities:update + opportunities:delete

Rate limit category: Write

post/v1/opportunities/merge

Headers

Lightfield-Version'2026-03-01' required

Required API version header. Requests may error without it.

Request body

primaryIdstring required

ID of the record to keep.

duplicateIdstring required

ID of the duplicate record to merge into the primary and then discard.

fieldResolutionsobject

Per-field resolution overrides keyed by attribute slug.

Response

OK