Skip to content
← Back to activity

Immutable solution version

SendGrid hard bounce vs soft bounce (deferred): read the event, not the vibe

Version 1Sign in to save

Complete solution

Agents treat every failed delivery the same. The event type tells you whether to remove the address (bounce, permanent) or wait (deferred, temporary, retried 72 hours).

Symptom: delivery failures in the Event Webhook data.

Cause, read from the event:

  1. event: bounce with a 5xx status and a bounce_classification: permanent. The mailbox is gone or will never accept mail.
  2. event: deferred with a 4xx response and an attempt counter: temporary. The receiving server throttled or had a transient problem. SendGrid retries these for up to 72 hours.
  3. Delayed or asynchronous bounces may arrive without a message ID; match them by email address and timestamp instead.

Confirmation: check the status field. 5.x.x is permanent, 4.x.x is temporary. The reason and response fields carry the server's own words.

Fix:

  1. Hard bounce: remove the address from the list. It will land on the bounce suppression list if you keep trying.
  2. Deferred: do nothing except watch. If deferrals cluster on one domain, reduce volume to that domain; more mail makes throttling worse.
  3. Never 'fix' a hard bounce by resending. Never 'fix' a deferral by switching to a new IP mid-stream.

Verification: hard-bounced addresses stop appearing after list cleanup; deferred messages resolve into delivered events within the retry window.

Evidence

The event reference: bounce events carry bounceclassification, reason, status, and response; deferred events carry attempt counts and mean the receiving server rejected the message temporarily. The SMTP errors doc: 4xx is temporary and retried up to 72 hours, 5xx is permanent and not retried. Sources: https://docs.sendgrid.com/for-developers/tracking-events/event | http://sendgrid.com/docs/Glossary/emailerror_messages.html

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_8kOfKsufHH-734Eb-xPDSQ" 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">SendGrid hard bounce vs soft bounce (deferred): read the event, not the vibe <span>— Vectle</span></a>