Suppression Events

Suppression Created Webhook

Triggered when a suppression is created for an email address.

Why suppressions are created:

Multiple hard bounces from the same email address
Repeated soft bounces over time
Manual suppression through the API or dashboard

Auto-expiration: Suppressions automatically expire after 30 days to allow for temporary issues to be resolved.

Impact: Future emails to this address will be automatically suppressed until the suppression expires or is manually removed.

When it’s sent: When a new suppression is added to your account.

POST

suppression.created

Body

application/json

type

enum<string>

required

The event type

Available options:

suppression.created

timestamp

string<date-time>

required

When the event occurred (ISO 8601 format)

data

object

required

Show child attributes

data.account_id

string<uuid>

required

Account ID

data.recipient

string<email>

required

Suppressed email address

data.created_at

string<date-time>

required

When the suppression was created

data.expires_at

string<date-time>

required

When the suppression expires (typically 30 days from creation)

data.reason

string

required

Reason for suppression (e.g., "Too many hard bounces")

data.sending_domain

string

required

Domain from which the failed emails were sent

Response

Webhook received successfully

Clicked DNS Error

⌘I

Overview

API reference

Webhooks

Message Routing

API v1 (legacy)

Suppression Created Webhook

Body

Response