How should we interpret the SMTP response code for this failed send?
Classify the complete SMTP reply before deciding whether to retry or repair the message. A 4yz response is transient, while a 5yz response is permanent for the unchanged attempt and requires a different operational response. Keep the enhanced code and diagnostic text because they identify the probable failure area.
First 15 minutes
- Preserve the full reply, SMTP stage, recipient scope, sending identity, message ID, timestamps, and retry history.
- Redact recipient content and personal data before sharing diagnostics outside the authorized incident team.
Now
- Retry 4yz failures with bounded backoff and stop unchanged attempts after 5yz failures.
Next 24 hours
- Change the message or destination implicated by a 5yz diagnostic before another attempt.
Next 7 days
- Codify provider-aware bounded backoff for transient failures and no-unchanged-retry handling for permanent failures.
Technical checks
Engineering
- Classify the three-digit reply as 2yz completion, 3yz continuation, 4yz transient failure, or 5yz permanent failure.
- Parse the enhanced code into class, subject, and detail.
- Use the X.1 through X.7 subject family to locate the probable failure category while retaining the provider detail.
- When the detail is unknown, report the recognized class and subject without inventing a diagnosis.
Verification criteria
- A transient 4yz path reaches a terminal outcome under bounded backoff, while an unchanged 5yz failure is not retried.
Escalation criteria
- Escalate an unknown detail code with the preserved raw reply, recognized class and subject, stage, scope, identities, timestamps, and retry history.
Prevention
- Enforce bounded backoff for 4yz replies and require a changed message or destination before retrying a 5yz failure.
- Retain privacy-minimized SMTP diagnostic packages for incident analysis.
Business impact
- A 4yz reply delays completion and a 5yz reply permanently fails the unchanged attempt; the enhanced subject identifies the probable failure category.
Open questions
- The raw SMTP reply, command stage, recipient scope, and provider-specific diagnostic text were not supplied, so the specific failure cannot be interpreted.
- Mailbox providers can attach provider-specific meanings to registered or extended detail codes; use their current code table after applying the standard class and subject.
Sources (6)
- RFC 5321: Simple Mail Transfer Protocol — Section 4.2.1, Reply Code SeveritiesIETF RFC 5321
- RFC 3463: Enhanced Mail System Status Codes — Section 2, Status Code StructureIETF RFC 3463
- RFC 3463: Enhanced Mail System Status Codes — Section 2, subject sub-code classificationsIETF RFC 3463
- RFC 3463: Enhanced Mail System Status Codes — Section 2, extensibility behaviorIETF RFC 3463
- RFC 3463: Enhanced Mail System Status Codes — Section 2, class sub-code definitionsIETF RFC 3463
- RFC 5321: Simple Mail Transfer Protocol — Sections 4.2 and 4.5.4.1IETF RFC 5321


