📘

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.

Deleted contacts

When we find a contact in the recycled bin with the same identifier that you pass in, we will undelete the contact and update with the passed details.

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 field's value clears the field

Only pass the fields you require updating for a contact.

We interpret a field passed with a null value (in other words, an empty field) as an instruction to clear the value for that field.

Note: This only works with data fields in this call,not identifiers.