Contact Imports

Import contacts from CSV. The engine parses the contact rows, groups the rows and existing ledger contacts that refer to the same entity, detects duplicates by similarity scoring across several fields, and presents a merge preview before commit.

Contacts flow through four states: upload, resolve (if there are conflicts), confirm, completed. No rows are lost or created in processing: every parsed row ends up created, merged, skipped, or flagged as an error.

The upload requires the contacts API key scope.

→ The Contact Imports object

Endpoints

GEThttps://app.speybooks.com/api/v1/contact-imports/List contact imports POSThttps://app.speybooks.com/api/v1/contact-imports/uploadUpload contacts file GEThttps://app.speybooks.com/api/v1/contact-imports/{id}Get contact import details DELETEhttps://app.speybooks.com/api/v1/contact-imports/{id}Delete a contact import POSThttps://app.speybooks.com/api/v1/contact-imports/{id}/confirmConfirm contact import POSThttps://app.speybooks.com/api/v1/contact-imports/{id}/resolveResolve identity conflicts

Endpoints

GET/v1/contact-imports/POST/v1/contact-imports/upload GET/v1/contact-imports/{id}DELETE/v1/contact-imports/{id}POST/v1/contact-imports/{id}/confirm POST/v1/contact-imports/{id}/resolve

The Contact Imports Objectjson

{
  "id": "dimp_1",
  "filename": "xero-contacts-export.csv",
  "totalRows": 47,
  "createdCount": 38,
  "skippedCount": 4,
  "errorCount": 0,
  "status": "completed",
  "engineVersion": "1.0.0",
  "hasConflicts": false
}