Webhooks

email.unsubscribed

Fires the first time a recipient unsubscribes from your mail.

The email.unsubscribed event fires the first time a recipient opts out — via an RFC 8058 one-click List-Unsubscribe, the unsubscribe footer link, or the hosted preference center. Repeat opt-outs of an already-unsubscribed address do not re-fire it.

The recipient is marked unsubscribed in the relevant audience, so future campaign sends skip them automatically.

{
  "type": "email.unsubscribed",
  "created_at": "2026-06-22T23:41:12.126Z",
  "data": {
    "recipient_email": "recipient@example.com",
    "audience_id": "aud_9f8c7b6a",
    "occurred_at": "2026-06-22T23:41:11.894Z"
  }
}

Payload

typestringoptional

The event type that triggered the webhook.

created_atstringoptional

ISO 8601 timestamp when the webhook event was created.

dataobjectoptional

Event-specific data. The fields below live inside this object.

data.recipient_emailstringoptional

The address that unsubscribed.

data.audience_idstringoptional

The audience (contact pool) the opt-out applied to.

data.occurred_atstringoptional

ISO 8601 timestamp when the unsubscribe was recorded.

Unsubscribe handling is sender-driven — MailBlastr records the opt-out and skips the recipient on future campaign sends; it does not modify your email body.

This is one of several events MailBlastr can deliver. See the full list of webhook event types.