Import a single contact

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 behavior

The 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 contacts

When 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 contacts

If 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.


🚧

Specifying null for a fields value clears the field

Please 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.

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