Import contacts
Create or update up to 5,000 contacts in one request.
/v1/contacts/importAPI keyThe body is a JSON array of contacts. Each one is upserted by email with the same rules as Create a contact: new addresses are created, existing ones get the fields you send, and a missing unsubscribed never re-subscribes anyone.
If the same address appears more than once in the array, the last entry wins.
The whole array is validated first. One invalid entry fails the request and nothing is imported.
Imported contacts are not added to any audience. Use Add contacts to an audience with the IDs afterwards.
Body
Between 1 and 5,000 contacts.
Show contact propertiesHide contact properties
The address. Stored lowercased.
Up to 200 characters.
Up to 200 characters.
Left out: new contacts are subscribed and existing ones keep their status.
Extra values for broadcast templates.
Response
How many addresses were new to the project.
How many addresses already existed and were updated.
Errors
| Status | Code | When |
|---|---|---|
| 400 | missing_body | The request has no body. |
| 400 | invalid_body | The body is not an array, is empty, has more than 5,000 entries, or an entry is invalid. param points at it, for example 12.email. |