Confirm contact import

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

Confirm a contact import, atomically creating the new contacts and merging the duplicates into the existing contacts.

Confirmation is blocked while unresolved conflicts remain. The row conservation holds at commit: created plus merged plus skipped equals the total imported rows.

Path parameters

idstringrequired

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

Response

200Import committed. Returns counts of created, merged, and skipped contacts.

Show response fields

createdinteger

importIdstring

mergedinteger

skippedinteger

totalinteger

Error codes

404Import not found or not a contacts import.

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

RequestPOST/v1/contact-imports/{id}/confirmcurl

curl -X POST https://api.speybooks.com/v1/contact-imports/dimp_1/confirm \
  -H "Authorization: Bearer sk_test_..."

Response200

{
  "success": true,
  "data": {
    "importId": "dimp_1",
    "created": 40,
    "merged": 6,
    "skipped": 1,
    "total": 47
  }
}