Nexiom ConnectDocs
Dashboard

Update a contact

Change a contact's profile, custom properties, or subscription status.

PUT/v1/emails/contacts/{contactId}

Authorization

Bearer token

Authorizationrequiredheader

Send your API key as Bearer YOUR_API_KEY.

Permissionemail.full_access

Path parameters

contactIdrequiredstring

The contact's ID, starting with con_.

Body parameters

application/json

emailrequiredstring

The contact's email address. Send the current address to keep it.

userIdoptionalstring or null

Your identifier for this person. null clears it.

firstNameoptionalstring

First name. An empty string clears the value.

lastNameoptionalstring

Last name. An empty string clears the value.

phoneNumberoptionalstring

Phone number.

propertiesoptionalobject

Replaces the contact's custom property values. Properties you leave out are cleared; omit the field to keep them unchanged.

emailStatusoptionalstring

Unsubscribing stops email to this address.

One of"subscribed""unsubscribed"

Fields you omit, other than email, keep their current values.

Response

application/json200 OK

The updated contact is returned under data, in the same shape as Create a contact. Changing emailStatus to unsubscribed also sends a contact.unsubscribed webhook event.

Nexiom Connect
Open dashboard