email.failed
The mail provider refused the message before any delivery attempt.
The mail provider refused the message before any delivery attempt — a virus verdict, a policy, a rendering failure. Nothing reached any recipient, and nothing will be retried: the message is failed.
Payload
PropType
email_idstring
eml_…
Type
stringthread_idstring
The conversation.
Type
stringdomain_idstring | null
The domain it was sent from, or null when sent through a mailbox.
Type
string | nullmailbox_idstring | null
The mailbox it was sent through, or null when sent from a domain.
Type
string | nullsuppression_keystring | null
The list the send named, when it named one.
Type
string | nullreasonstring
What the provider said.
Type
stringHandling it
if (event.type === "email.failed") {
await flagForReview(event.data.email_id, event.data.reason)
}A refusal is about the message, not the address: no suppression is written, and the same recipient can be written to again once the content is fixed.