v19

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

Merge two contacts

Merges two contacts into one. The primary contact retains its ID; the duplicate is soft-deleted.

Required scopes: contacts:update + contacts:delete

Rate limit category: Write

post/v1/contacts/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