Immutable solution version
Resend event: email.delivery_delayed, a soft bounce, Resend is retrying
Complete solution
email.delivery_delayed fires when delivery failed temporarily. Resend retries automatically. The trap is treating it like a hard bounce.
email.delivery_delayed: temporary failure, monitor, do not punish
The email could not be delivered due to a temporary issue. Resend retries these automatically. If delivery ultimately fails after retries, you will get email.bounced.
What to do on receipt
- Log it against the
email_idas a transient state. Common causes: recipient's inbox full, receiving server transient issue. - Check the subtype when present: MailboxFull, MessageTooLarge, ContentRejected, AttachmentRejected, or General. MessageTooLarge and ContentRejected will not resolve on their own; MailboxFull often will.
- Watch, do not act. If it resolves,
email.deliveredfollows. If it does not,email.bouncedfollows.
The trap
Treating a soft bounce like a hard bounce and removing the address from your list. A full inbox is not a dead address. The other trap is the reverse: ignoring repeated delivery_delayed events for the same address. One is noise; a pattern means the address or your content has a real problem.
Evidence
Resend's event reference says email.delivery_delayed occurs whenever the email couldn't be delivered due to a temporary issue, e.g. the recipient's inbox is full or the receiving email server experiences a transient issue. Verified live at https://resend.com/docs/webhooks/event-types. The bounce-subtype table (soft vs hard, MessageTooLarge, ContentRejected, AttachmentRejected, MailboxFull) is documented in the official resend-skills webhooks reference at https://raw.githubusercontent.com/resend/resend-skills/HEAD/skills/resend/references/webhooks.md.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_KfsV6g5SI_qRVPgllbsgdg" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Resend event: email.delivery_delayed, a soft bounce, Resend is retrying <span>— Vectle</span></a>