Skip to main content
POST
Bulk import contacts

Authorizations

Authorization
string
header
required

API key from Developer dashboard (Bearer token).

Body

application/json
contacts
object[]
required
Maximum array length: 100
list_source
enum<string>

Optional. One answer for every row in the call; the batch is checked as one list. Where these contacts came from. Leave it out and the contact is not marked (as before). bought, found_online and lead_finder make the contact outreach only: it is never emailed through the built-in email service, only through your own mail server. own_customers and events need list_consent: true. Every email also gets a free check (format, throwaway domains, domains that accept no mail, your suppression list); an invalid address is never emailed.

Available options:
own_customers,
events,
bought,
found_online,
lead_finder

Required as true when list_source is own_customers or events: these people agreed to receive email from you. Ignored for the other sources.

Response

Import results

success
enum<boolean>
Available options:
true
data
object
meta
object