Skip to main content
POST
Merge Duplicate Group

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string | null

Path Parameters

group_id
string
required

Duplicate group to merge.

Body

application/json

Merge a duplicate group into one surviving record.

Irreversible: every record in loser_ids is merged into winner_id and then permanently deleted. Their activities, deals, tasks and enrollments are reparented onto the winner first.

winner_id
string
required

Id of the record that survives the merge.

loser_ids
string[]
required

Ids of the records to merge into the winner and then permanently delete. Must be members of the group.

Minimum array length: 1
field_choices
MergeFieldChoice · object[]

Per-field overrides. Any field omitted keeps the winner's own value, or the loser's when the winner's is empty.

expected_member_key
string | null

The group's member_key as shown to the reviewer. If the set of records in the group changed since, the merge is rejected with 409 rather than applied to something the reviewer did not see. Deliberately not a timestamp: every scheduled rescan touches the group's last_seen_at, so a timestamp would reject a perfectly valid review just because a nightly scan ran.

Response

Successful Response