Skip to main content

Unsubscribed

Unsubscribed callbacks are triggered when a recipient unsubscribes from your emails. These callbacks allow you to keep your mailing lists up to date and ensure compliance with recipient preferences.

Unsubscribed Webhook Payload

ParameterTypeRequiredDescriptionExample
channelstringtrueAlways emailemail
event_typestringtrueAlways email_unsubscribedemail_unsubscribed
batch_idstringtrueUUID auto-generated per API send request and returned in the send response. Shared across all recipients (to, cc, bcc) of that single send.550e8400-e29b-41d4-a716-446655440000
message_idstringtrueInternal identifier for the individual recipient record507f1f77bcf86cd799439011
tagstringfalseCustom tag sent with the emailwelcome-email
bulk_tagstringfalseUser-provided string for grouping multiple sends across separate API callscampaign-april
event_metaobjecttrueEvent-specific metadata
event_meta.tostringtrueRecipient email address[email protected]
event_meta.linkstringtrueAlways empty for this event type""
event_meta.sent_atstringtrueTimestamp of the event in ISO 8601 format2024-01-15T10:30:00Z