SMTP (Simple Mail Transfer Protocol) servers communicate mail delivery status using three-digit numeric response codes. Understanding these status codes is crucial for developers building transactional email systems and managing outbound bounces. Let's explore the SMTP status code hierarchy.
SMTP Response Categories
The first digit of an SMTP status code indicates the class of response:
- 2xx (Success): The server successfully accepted and processed the command. (e.g.,
250 OK). - 3xx (Intermediate): The server accepted the command, but requires additional information before proceeding. (e.g.,
354 Start Mail Input). - 4xx (Transient Failure): The command failed due to a temporary issue. The client should retry sending later. (e.g.,
421 Service Not Available). - 5xx (Permanent Failure): The command failed due to a permanent error. The client must not retry. (e.g.,
550 Mailbox Not Found).
Common Status Codes Explained
When debugging bounce logs, look out for these common codes: 451 Requested Action Aborted indicates local processing errors. 554 Transaction Failed means the recipient server rejected the email, often due to SPF failures, bad domain reputation, or spam content triggers.