# WhatsApp suppression webhooks

`whatsapp_suppression.created` fires when a suppression opens on the workspace's [suppression list](/docs/guides/whatsapp/opt-outs/suppressions), so your own systems can see new blocks without polling.

## The payload

```json
{
  "type": "whatsapp_suppression.created",
  "timestamp": "2026-08-25T14:52:03.192524705Z",
  "data": {
    "suppression_id": "was_01krdgeqcxet5s7t44vh8rt9mg",
    "address": "+14155550100",
    "waba": null,
    "reason": "manual",
    "workspace_id": "ws_01ky7m21hjffh9s8kq76gyb1xf"
  }
}
```

- `suppression_id` names the suppression.
- `address` is the suppressed number in E.164 format.
- `waba` is the WhatsApp Business Account the block is limited to, or `null` when it covers the whole workspace, whichever account sends.
- `reason` says why the suppression opened.
- `workspace_id` is the workspace that owns the list.

## What does not fire

Only openings fire an event. Ending a suppression does not yet, so re-read the list before treating a mirrored block as still standing.

An opt-out the recipient stated themselves is a [preference](/docs/guides/webhooks#preference-events) rather than a suppression, and fires `preference.revoked` instead.

## Next steps

- [Suppressions](/docs/guides/whatsapp/opt-outs/suppressions): how a suppression blocks sends and how to manage the list
- [Preferences](/docs/guides/whatsapp/opt-outs/preferences): opt-outs the recipient stated themselves

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)