Update contact
Update or create a contact.
Update an existing contact by sending a request containing contact properties.
This endpoint will create a contact if a matching contact does not already exist in your audience.
If you want to update a contact’s email address, the contact will first need a
userId value. You can then make a request containing the userId field
along with an updated email address.
Request
Body
The contact’s email address. If there is no contact with this email, one will be created.
The contact’s first name.
The contact’s last name.
A custom source value to replace the default “API”. Read more
Whether the contact will receive campaign and loops emails. Read more
You can use groups to segment users when sending emails. Currently, a contact can only be in one user group. Read more
A unique user ID (for example, from an external application). Read more
Key-value pairs of mailing list IDs and a boolean denoting if the contact
should be added (true) or removed (false) from the list. Read
more
{
"mailingLists": {
"list_123": true,
"list_456": false
}
}
Custom properties
You can also include custom contact properties in your request body. These should be added as top-level attributes in the request.
Custom properties can be of type string, number, boolean or date (see allowed date formats).
{
"email": "[email protected]",
"plan": "pro", /* Custom property */
"favoriteColor": "Blue" /* Custom property */
}
There are a few reserved names that you cannot use for custom properties.
To empty or reset the value of a contact property, send a null value.
Response
Success
The ID of the contact.
Error
An error message.
Was this page helpful?