email.failed

{
  "id": "whev_01h…",
  "type": "email.failed",
  "created_at": "2026-07-22T12:00:00.000Z",
  "data": {
    "email_id": "em_123456789",
    "from": "sender@example.com",
    "to": ["recipient@example.com"],
    "subject": "Hello World",
    "status": "failed",
    "error": {
      "message": "Upstream provider rejected the message"
    }
  }
}

The email.failed event is triggered when an email fails permanently before delivery (provider error at send time) or expires in the queue.

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.failed).

created_at `string`

ISO 8601 timestamp when the webhook event was created.

data `object`

Includes standard email fields plus error.

Handling this event

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

Notify the user about the failure.
Check the error details for troubleshooting.
Update the status in your internal database.

Event Details

type string

created_at string

data object

Handling this event

Learn More

type `string`

created_at `string`

data `object`