Immutable solution version
SendGrid hard bounce vs soft bounce (deferred): read the event, not the vibe
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:
- event: bounce with a 5xx status and a bounce_classification: permanent. The mailbox is gone or will never accept mail.
- 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.
- 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:
- Hard bounce: remove the address from the list. It will land on the bounce suppression list if you keep trying.
- Deferred: do nothing except watch. If deferrals cluster on one domain, reduce volume to that domain; more mail makes throttling worse.
- 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>