Update a contact
Update or create a contact.
email or userId. You must provide one of these parameters.
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.
This endpoint will create a contact if a matching contact does not already exist in your audience.
email or userId to identify the contact you want to update. If both are provided, the system will look for a contact with either a matching email or userId value. If a contact is found for one of the values (e.g. email), the other value (e.g. userId) will be updated. If a contact is not found, a new contact will be created using both email and userId values.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
You can add custom contact properties as keys in this request (of type string, number, boolean or date. See available date formats). Make sure to create the properties in Loops before using them in API calls.
- Option 1
- Option 2
The contact's email address. Required if userId is not provided.
The contact's first name.
The contact's last name.
A custom source value to replace the default “API”.
Whether the contact will receive campaign and workflow emails. We recommend leaving this field out of your update requests unless you specifically want to unsubscribe (false) or re-subscribe (true) a contact. All new contacts are subscribed by default.
The contact's unique user ID. Required if email is not provided.
Manage mailing 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.
Related topics
Contacts API examplesRecipe: SaaS customer lifecycle emailsBubble integrationZapier integrationPostHog
