Contacts

Start an async contact import

Import a batch of contacts (up to 5,000 per request) in the background. The call returns immediately with an import job you poll for progress and per-row results — new contacts are created and existing ones (matched by email) are skipped, not changed. Track it with Retrieve a contact import, or see all your imports via List contact imports. To add a single contact synchronously, use Create a contact. Requires the contacts:write capability.

post/contacts/imports

Request

  • Base URL: https://www.unitpost.com/api/v1
  • URL: https://www.unitpost.com/api/v1/contacts/imports
  • Auth: HTTP bearer

Request body

Response

Accepted; the import job was enqueued.

object'contact_import' required
idstring required
status'pending' | 'processing' | 'completed' | 'failed' | 'canceled' required
totalnumber required
importednumber required
skippednumber required
failednumber required
errorstring nullable required
created_atstring required
updated_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.