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:
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 fieldYou 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.