{
"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 Event
The suppression.created webhook fires when AhaSend adds an address to your suppression list, for example after hard bounces. Includes reason and expiry.
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"
}
}AhaSend sends this event 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
expires_at value.
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.
Suppression duration depends on its cause, rather than a single fixed expiry. See suppression durations.
Related Guides
- API authentication, Permission scopes, Webhook setup.
- Event reference, Webhook CLI, Local webhook testing.
- Signature verification, Retry policy, API errors.
- API rate limits, Suppression durations.
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