Webhook events

suppression.added

An address was added to the team's suppression list.

When it fires

suppression.added fires when an address joins the team's suppression list: added by hand in the dashboard, added through the REST API, or recorded automatically after a permanent bounce or a complaint.

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

Payload

json

{
  "type": "suppression.added",
  "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"
  }
}

Field	Description
`id`	The suppression's ID.
`email`	The suppressed address, in lowercase.
`origin`	`manual`, `bounce`, or `complaint`.
`source_id`	The 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_at`	When the address was suppressed.

Adding an address that is already on the list emits nothing, even when the entry's reason changes.

Handle the event

Verify the signature and deduplicate by svix-id.