What is a “custom” SMTP code?
Still have a question, spotted an error, or have a better explanation or a source we should cite?
You're scanning your delivery logs after a rough send, and instead of a clean "550 5.1.1" you see something like "421 RP-001" or "550 SC-001". Standard SMTP docs don't explain it. That's a custom SMTP code, and you're going to run into them constantly.
Standard SMTP reply codes are defined by RFC 5321. They're three-digit numbers (like 421 for a temporary failure or 550 for a permanent rejection) that any mail server in the world is supposed to understand the same way. Custom codes extend those standards with proprietary sub-codes or message strings that only the issuing provider documents (and sometimes doesn't document all that clearly).
Here's how the major providers use them in practice. Microsoft 365 is probably the most famous for this. Codes like "421 RP-001" signal rate limiting, "550 SC-001" points to reputation-based blocking, and "550 5.7.1 COL004" often means the sending IP has been flagged. These aren't in any RFC. You need Microsoft's own postmaster documentation to decode them. Gmail takes a different approach. It sticks to standard code numbers but adds detailed reason strings in plain English, which makes life a bit easier. Yahoo Mail layers in policy-specific messages that describe exactly which rule you tripped, usually around bulk sending or content filters.
The challenge with custom codes is that they can change without warning. A sub-code that meant one thing last year might mean something slightly different today, or disappear entirely after a platform update. If you're building bounce parsing logic, you can't assume the sub-code list is stable.
Practically speaking, there are three things worth doing. First, bookmark the postmaster pages for the providers you send to most. Microsoft, Gmail, and Yahoo all publish some level of documentation (even if it's incomplete). Second, build your bounce handling to treat unknown sub-codes as soft failures until you can look them up. Immediately suppressing an address because of an unfamiliar 5xx sub-code can lose you valid subscribers. Third, track patterns. If "550 RP-002" starts appearing in volume after a particular campaign, that's a signal worth investigating rather than ignoring.
If you're seeing a flood of unfamiliar codes right now and can't figure out what's triggering them, our SOS hotline is free and we're happy to take a look with you.
Contributors
Who worked on this answer
Every name links to their profile. Every company links to their site. Real people, real accountability.
