{
"type": "message.failed",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2024-05-06T09:55:16.687031577Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"event": "on_failed",
"from": "sender@example.com",
"recipient": "invalid@nonexistent-domain.com",
"subject": "Welcome to our service",
"message_id_header": "<message-id-12345@localhost>",
"id": "407926766d2711f09b30960002cafe7c"
}
}Message Events
message.failed Webhook Event
The message.failed webhook fires when an AhaSend email exhausts its retry window without delivery. Learn how it differs from message.bounced.
WEBHOOK
message.failed
{
"type": "message.failed",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2024-05-06T09:55:16.687031577Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"event": "on_failed",
"from": "sender@example.com",
"recipient": "invalid@nonexistent-domain.com",
"subject": "Welcome to our service",
"message_id_header": "<message-id-12345@localhost>",
"id": "407926766d2711f09b30960002cafe7c"
}
}AhaSend sends this event when an email exhausts its retry window without being delivered.
No more delivery attempts will be made. This event reports retry exhaustion rather than one specific SMTP exchange, so
data.delivery_attempt is omitted. An immediate permanent rejection from a recipient server is reported as message.bounced instead.
When it’s sent: After all retry attempts have been exhausted.
Related Guides
- API authentication, Permission scopes, Webhook setup.
- Event reference, Webhook CLI, Local webhook testing.
- Signature verification, Retry policy, API errors.
- API rate limits.
Body
application/json
The event type
Available options:
message.failed The webhook ID (the same ID as returned by the Create Webhook API)
When the event occurred (ISO 8601 format)
Show child attributes
Show child attributes
Response
Webhook received successfully