{
"type": "message.transient_error",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2024-05-06T09:51:16.687031577Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"event": "on_transient_error",
"from": "sender@example.com",
"recipient": "recipient@example.com",
"subject": "Welcome to our service",
"message_id_header": "<message-id-12345@localhost>",
"id": "407926766d2711f09b30960002cafe7c",
"delivery_attempt": {
"classification": "QuotaIssues",
"smtp_code": 452,
"enhanced_status_code": "4.2.2",
"response": "The recipient's inbox is out of storage space",
"command": "RCPT TO"
}
}
}Message Events
message.transient_error (Deferred) Webhook Event
The message.transient_error webhook fires when AhaSend defers an email after a temporary (soft bounce) failure and will retry delivery. Payload and causes.
WEBHOOK
message.transient_error
{
"type": "message.transient_error",
"webhook_id": "abe11757-2886-4b55-96f1-0e0afc95795a",
"timestamp": "2024-05-06T09:51:16.687031577Z",
"data": {
"account_id": "4cdd7bdd-294e-4762-892f-83d40abf5a87",
"event": "on_transient_error",
"from": "sender@example.com",
"recipient": "recipient@example.com",
"subject": "Welcome to our service",
"message_id_header": "<message-id-12345@localhost>",
"id": "407926766d2711f09b30960002cafe7c",
"delivery_attempt": {
"classification": "QuotaIssues",
"smtp_code": 452,
"enhanced_status_code": "4.2.2",
"response": "The recipient's inbox is out of storage space",
"command": "RCPT TO"
}
}
}AhaSend sends this event when an email delivery is delayed due to a temporary issue with the receiving mail server.
This is a temporary failure (soft bounce). AhaSend will retry delivery according to its retry policy. Common causes include:
- Recipient’s mailbox is full
- Temporary server issues
- Rate limiting by the recipient’s server
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.transient_error 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

