Imports a single contact; if it is an existing contact it updates the contact with just the fields passed in the request with a choice of how to handle the merging of data, otherwise it create a new contact.
Request behaviorThe
identifier
specified in the URL path is used to uniquely identify a contact. This can be a custom identifier or a system contact identifier; contactId, email, or mobileNumber.
Existing contactsWhen we find a contact in the account with the specified identifier, the contact record is updated with any data supplied in the object in the request body.
New contactsIf no contact is found with the provided identifier, the contact is created using the identifiers supplied in the object in the request body. The object must contain either an email address or mobile number in the
identifiers
field.
Specifyingnull
for a fields value clears the fieldPlease ensure you only pass the fields you require updating on a contact!
We will interpret a field passed with a
null
value as an instruction to clear the value for that field.