Skip to main content

Unsubscribe from messages

The Engage API has endpoints to allow unsubscribing of contacts from emails and SMS messages.

Unsubscribe from a specific message

Using these two endpoints, a contact can be unsubscribed from a specific email or SMS. This is effectively the same as them unsubscribing via the unsubscribe link in an email, or through the unsubscribe link in an SMS.

POST /api/v3/contacts/{contactId}/unsubscribeEmail?messageId={messageId}

POST /api/v3/contacts/{contactId}/unsubscribeSms?messageId={messageId}

Note

If messageId is not sent in the request, the messageId of the last message received by the contact will be used.

Field

Type

Example value

contactId (mandatory)

GUID

a67b201f-d86d-4ee2-bdc7-abce0080a803

messageId

GUID

f0370cc7-5428-4cc3-85c9-ad0800f0bc28