Confirm contact import

POST https://app.speybooks.com/api/v1/contact-imports/{id}/confirm

Confirm a contact import, atomically committing new contacts and merging duplicates into the identity graph. Creates identity anchors, inserts hard keys (with singularity constraint enforcement), stores identity attributes, and upserts contact rows.

The blocking rule prevents confirmation while unresolved conflicts remain (|E| > 0). The total row conservation law is enforced: created + merged + skipped must equal total import nodes.

For merge outcomes targeting existing ledger contacts, progressive adoption creates identity anchors for previously unanchored contacts.

Path parameters

id string required
Data import ID (e.g. dimp_1). Must be in pending status (all conflicts resolved).

Response

200 Import committed. Returns counts of created, merged, and skipped contacts.
Show response fields
created integer
importId string
merged integer
skipped integer
total integer

Error codes

404 Import not found or not a contacts import.
409 Import already completed, still has unresolved conflicts (processing), or is in a non-confirmable status.