{
  "type": "suppression.created",
  "webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
  "timestamp": "2024-05-06T12:57:06.451529527Z",
  "data": {
    "account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
    "recipient": "bounced@example.com",
    "created_at": "2024-05-06T12:57:06.451529617Z",
    "expires_at": "2024-06-05T12:57:06.451529617Z",
    "reason": "Too many hard bounces",
    "sending_domain": "your-domain.com"
  }
}

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.

WEBHOOK

suppression.created

{
  "type": "suppression.created",
  "webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
  "timestamp": "2024-05-06T12:57:06.451529527Z",
  "data": {
    "account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
    "recipient": "bounced@example.com",
    "created_at": "2024-05-06T12:57:06.451529617Z",
    "expires_at": "2024-06-05T12:57:06.451529617Z",
    "reason": "Too many hard bounces",
    "sending_domain": "your-domain.com"
  }
}

Body

application/json

type

enum<string>

required

The event type

Available options:

suppression.created

webhook_id

string<uuid>

required

The webhook ID (the same ID as returned by the Create Webhook API)

timestamp

string<date-time>

required

When the event occurred (ISO 8601 format)

data

object

required

Show child attributes

Response

Webhook received successfully

Overview

API reference

Webhooks

Message Routing

API v1 (legacy)

Suppression Created Webhook

Body

Response