Skip to main content
Event triggered whenever the email failed to send due to an error. This event is triggered when there are issues such as invalid recipients, API key problems, domain verification issues, email quota limits, or other sending failures.

Response Body Parameters

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 (e.g., email.failed).
​
created_at
string
ISO 8601 timestamp when the webhook event was created.
​
data
object
Event-specific data containing detailed information about the event. The data object for the email.failed event contains the following parameters:
{
  "type": "email.failed",
  "created_at": "2024-11-22T23:41:12.126Z",
  "data": {
    "broadcast_id": "8b146471-e88e-4322-86af-016cd36fd216",
    "created_at": "2024-11-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <[email protected]>",
    "to": ["[email protected]"],
    "subject": "Sending this example",
    "template_id": "43f68331-0622-4e15-8202-246a0388854b",
    "failed": {
      "reason": "reached_daily_quota"
    },
    "tags": {
      "category": "confirm_email"
    }
  }
}