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").

{
  "contacts": [
    { "email": "[email protected]", "firstName": "Alice", "source": "csv" },
    { "email": "[email protected]", "status": "unsubscribed" }
  ]
}

{ "affected": 2 }

Import Contacts