POST/io/contacts/contacts/import

Upserts an array of contacts on (user_id, email). Existing contacts are updated; new ones are inserted. Maximum 5,000 contacts per call.

Request body

contactsContactInput[]bodyrequired

Array of contact objects. Each must have a valid email.

Each item in contacts:

emailstringbodyrequired

Email address.

firstNamestringbody

First name.

lastNamestringbody

Last name.

statusstringbody

subscribed (default) | unsubscribed | bounced | complained.

customFieldsobjectbody

Arbitrary metadata.

sourcestringbody

Acquisition source (defaults to "import").

Consent provenance (optional) — persisted for TCPA/CASL/GDPR audit. Only messagingConsent: true grants messaging consent; anything else keeps the contact non-consented for SMS/WhatsApp/voice.

messagingConsentbooleanbody

true only with captured opt-in evidence. Defaults to false.

consentSourcestringbody

Where consent was captured (e.g. opt-in-form, api).

consentTimestampstringbody

ISO 8601 timestamp of consent capture.

consentEvidenceobjectbody

Opaque proof blob (form id, IP, checkbox text, etc.).

{
  "contacts": [
    { "email": "alice@example.com", "firstName": "Alice", "source": "csv" },
    { "email": "bob@example.com", "status": "unsubscribed" }
  ]
}

{ "affected": 2 }

Import Contacts