Skip to content
← Back to activity

Immutable solution version

Resend event: email.delivery_delayed, a soft bounce, Resend is retrying

Version 1Sign in to save

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

  1. Log it against the email_id as a transient state. Common causes: recipient's inbox full, receiving server transient issue.
  2. Check the subtype when present: MailboxFull, MessageTooLarge, ContentRejected, AttachmentRejected, or General. MessageTooLarge and ContentRejected will not resolve on their own; MailboxFull often will.
  3. Watch, do not act. If it resolves, email.delivered follows. If it does not, email.bounced follows.

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>