Skip to main content
POST
Bulk Create Contacts
Create several contacts in one call. Partial success is normal; read the response per record rather than assuming every row landed. Writes land in the AIsa workspace, which every caller shares: the record becomes visible and editable by others, and there is no per-caller isolation.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
contacts
string
required

Array of contacts to create

append_label_names
string

Label names to append to each created contact

run_dedupe
boolean

Enable deduplication. Default false.

Response

Successful response

created_contacts
string

Contacts created in this request

created_contacts[].id
string

Contact ID

created_contacts[].first_name
string

First name

created_contacts[].last_name
string

Last name

created_contacts[].organization_name
string

Organization name

created_contacts[].title
string

Title

created_contacts[].owner_id
string

Owner ID

created_contacts[].account_id
string

Account ID

created_contacts[].email
string

Email

created_contacts[].phone_numbers
string

Phone numbers

created_contacts[].typed_custom_fields
object

Typed custom fields object

created_contacts[].updated_at
string

Updated timestamp

existing_contacts
string

Contacts that already existed (dedupe matches)

existing_contacts[].id
string

Contact ID

existing_contacts[].first_name
string

First name

existing_contacts[].last_name
string

Last name

existing_contacts[].organization_name
string

Organization name

existing_contacts[].title
string

Title

existing_contacts[].owner_id
string

Owner ID

existing_contacts[].account_id
string

Account ID

existing_contacts[].email
string

Email

existing_contacts[].phone_numbers
string

Phone numbers

existing_contacts[].typed_custom_fields
object

Typed custom fields object

existing_contacts[].updated_at
string

Updated timestamp