Retrieve the status of a contacts import request

Retrieves the status of a contacts import request and the results if available.

Note: When importing, contacts are created or updated but if any associated data sets fail to import then details of these are included in the failures results

Possible failure codes

The following table lists some of the possible failure codes that can be returned when I contact cannot be imported in the failureCode field:


Failure codeDescription
ApiSchemaViolationThe JSON passed for the contact was schema invalid
Blocker
DuplicateYou have passed a duplicate identifier
GloballySuppressedGlobally Suppressed, so a barred identifier has been passed
InvalidEmailThe email address passed for the contact was not formatted correctly or contains invalid characters
InvalidContactIdThe contact id was invalid; it must be a numeric integer
InvalidPhoneNumberThe phone number passed for the contact was not formatted correctly, needs to be E.164 format
InvalidDomainThe email address passed has an invalid domain section
InvalidContactThe JSON passed for the contact was schema invalid
InvalidAddressBookIdsThe list / address book ids passed are unrecognized
InvalidMatchIdentifierThe match identifier passed is unrecognized
InvalidContactStatusThe contact status passed is unrecognized
NoValidIdentifiersNo valid identifiers were passed, so no action could be taken
SuppressedByDomainThe email address passed belongs to a domain that cannot be contacted
Language
Authorization
Basic
base64
:
URL
Click Try It! to start a request and see the response here!