contacts
Merge duplicate contacts (v2)
Merge one or more groups of duplicate contacts. The request body is { contactIds: string[][] } — each inner array is a group of ≥2 contact IDs to merge into a single surviving contact. Returns { data: { merged: Contact[], failed: [...] } }: merged holds the surviving contacts, failed lists any groups that could not be merged. Idempotency-Key is REQUIRED.
post/v2/contacts/merge
Headers
Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A
Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.
Request body
Response
Successful response