{
"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
The event type
Available options:
suppression.created The webhook ID (the same ID as returned by the Create Webhook API)
When the event occurred (ISO 8601 format)
Show child attributes
Show child attributes
Response
Webhook received successfully