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.
Whether the contact will receive campaign and loops emails. Read more.
If you send subscribed: true
in your update calls, contacts who have previously unsubscribed will be re-subscribed. We recommend leaving this field out of your requests unless you specifically want to unsubscribe or re-subscribe a contact.
You can use groups to segment users when sending emails. Currently, a contact can only be in one user group. Read more
Manage mailling list subscriptions.
Include 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
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).
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
Errors will be 400 Bad Request
.
An error message describing the problem with the request.