Skip to documentation

Webhook events

suppression.removed

An address was removed from the team's suppression list.

When it fires

suppression.removed fires when an address is removed from the team's suppression list in the dashboard or through the REST API.

The Add webhook form in the dashboard does not list this event type. Subscribe to it through the webhooks API.

Payload

json
{
  "type": "suppression.removed",
  "created_at": "2026-09-29T10:00:00.000Z",
  "data": {
    "id": "YOUR_SUPPRESSION_ID",
    "email": "you@example.net",
    "origin": "bounce",
    "source_id": "YOUR_EMAIL_ID",
    "created_at": "2026-09-29T09:59:59.000Z"
  }
}
FieldDescription
idThe suppression's ID.
emailThe suppressed address, in lowercase.
originmanual, bounce, or complaint.
source_idThe ID of the email whose bounce or complaint caused the suppression. null for manual entries and for entries recorded before source IDs were stored.
created_atWhen the address was suppressed.

data holds the entry as it was before removal.

Handle the event

Verify the signature and deduplicate by svix-id.