Import contact collection

Imports a collection of contacts. Creates contacts if they do not exist and updates contacts if they do. This is an async operation and you will need to check when it is complete by calling getImportStatus

Note: It isn't possible to specify the value for the contactId field when creating a contact, so it is only used to check for a matching contact when specified


This method allows you submit data in bulk and an asynchronous calling pattern:

1194

Bulk data upload calling pattern

The method for polling for import job status is Get import status and once complete also returns the import report showing what contacts were created, updated or failed; this is also when you can capture the contactId for each contact sent to Dotdigital.


📘

Phone numbers

Phone numbers must be in international format (E.164); Google have a good library for reformatting phone number called libphonenumber which has been ported to most languages.

📘

Import limits

Your JSON request body can be a maximum size of 50MB, therefore allowing a large number of contacts to be imported in a single call.

Active contact imports are limited to 25. If you exceed this limit, you get the Too many active imports error.

🚧

Specifying null for a fields value clears the field

You must ensure that you only pass the fields you require to be updated for a contact.

We interpret a field passed with a null value as an instruction to clear the value for that field.

Language
Credentials
Basic
base64
:
URL
Click Try It! to start a request and see the response here!