For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/webhooks/emails/bounced.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.

email.bounced

Webhook event triggered when an email permanently fails delivery.

{
  "id": "whev_01h…",
  "type": "email.bounced",
  "created_at": "2026-07-22T12:00:00.000Z",
  "data": {
    "email_id": "em_123456789",
    "from": "sender@example.com",
    "to": ["bad@example.com"],
    "subject": "Hello World",
    "status": "bounced",
    "error": {
      "code": 550,
      "message": "User unknown"
    }
  }
}

The email.bounced event is triggered when delivery permanently fails (hard bounce, admin bounce, or OOB).

Event Details

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

type string

The event type that triggered the webhook (email.bounced).

created_at string

ISO 8601 timestamp when the webhook event was created.

data object

Includes standard email fields plus error with SMTP details when available.

Handling this event

When your endpoint receives an email.bounced event, you might want to:

  • Suppress the recipient from future sends.
  • Notify the sender or update CRM status.

Learn More

Was this page helpful?

Edit this page