Skip to main content

Voyado Engage

Update a contact

Updating the details of a Voyado Engage contact is done through the contacts endpoint using their contactId:

https://[client].voyado.com/api/v2/contacts/{contactId}

If you don’t have the contact ID, you can get it using other contact attributes.

When you have the contactId you call the endpoint like this:

https://[client].voyado.com/api/v2/contacts/430d3329-7eef-45c0-37f9-ae9300a0daceid

And then send, as the payload, the attributes that you want to change:

{
    "lastName": "Smith",
    "street": "New Street 1337"
}

In this example, the contact has changed their surname and moved to a new address. These will now be updated.

Caution

Do not send null or empty values when updating a contact as they will override existing values.

Promoting a contact to Member

Two endpoints used to change contactType from Contact to Member have been deprecated and should not be used for new integrations. These deprecated endpoints are:

https://[client].voyado.com/api/v2/contacts/{contactId}/promoteToMember

https://[client].voyado.com/api/v2/contacts/{contactId}/updateContactType

The preferred way to change contactType for a contact is now through the update functionality shown above, by using the following payload:

{
    "contactType": "Member",
}

Caution

Promote a contact to Member only by doing a contacts update as shown above.