BETA

Yahoo / AOL SMTP Error Code Directory

[TSS] deferral codes, spam blocks, rate limits, and sender policy errors — decoded

🔧 Related Tools

ANALYSIS TOOLS
DIAGNOSTIC TOOLS
BUILDER TOOLS

Yahoo / AOL SMTP Error Code Directory

Yahoo Mail and AOL — both operated by Yahoo Inc. — embed proprietary deferral codes in square brackets inside standard SMTP responses. You will see codes like [TSS02] or [TS06] mixed in with the usual SMTP text, and they carry a specific meaning. This directory covers both the standard codes with Yahoo-specific behaviour and the proprietary [TSS]/[TS] codes — with a plain-English explanation and a fix for each.

Provider
Yahoo Mail / AOL Mail / Yahoo Inc.
Key Identifiers
[TSS] · [TS] · mta5.am0.yahoodns.net
MX Hostname Pattern
*.yahoodns.net · *.aol.com

How to Identify a Yahoo / AOL Bounce

Yahoo bounces appear with the Remote-MTA containing yahoodns.net or aol.com. The diagnostic text includes a bracketed code like [TSS02] inside the human-readable rejection reason.

421 4.7.0 [TSS02] Messages from 198.51.100.1 temporarily deferred due to user
complaints or because the IP/domain is in the unverified category. Please make
sure that your email is RFC-5321 compliant. ec=ax9 [16]

The [TSS02] code identifies the specific Yahoo throttling reason. ec=ax9 [16] is an internal transaction identifier and can be ignored.

Standard Codes with Yahoo-Specific Behaviour

These standard SMTP codes have documented Yahoo-specific behaviour or responses.

🔴 550 5.1.1 CRITICAL
Mailbox Does Not Exist
Yahoo returns: "No such user here." This is final — the address does not exist on their system.
Full explanation & fix →

Yahoo Proprietary [TSS] and [TS] Codes

These bracketed codes appear inside Yahoo's SMTP rejection text. They provide more specific reasons than the outer SMTP code alone.

🟡 [TSS02] 421 4.7.0
Too Many Connections from IP
Your sending IP is opening too many simultaneous SMTP connections to Yahoo's servers. Reduce concurrent connections to 1–3 per IP.
🟡 [TSS04] 421 4.7.0
Too Many Messages — Rate Limited
You are sending too many messages per hour from this IP. Throttle your sending rate and retry with exponential back-off.
🟡 [TSS05] 421 4.7.0
Service Temporarily Unavailable
Yahoo is temporarily limiting new connections. Retry after a 15–30 minute delay. Your mail server should handle this automatically.
🔴 [TSS07] 550 5.7.0
Message Blocked — Spam / Policy
Yahoo has blocked this message or sender due to spam complaints or policy violations. Check your sender reputation via Yahoo Postmaster.
🟡 [TS02] 421 4.7.0
Too Many Connections (Legacy)
Older Yahoo format for connection throttling. Same meaning as TSS02 — reduce concurrent SMTP connections.
🔴 [TS06] 550 5.7.0
Bad Reputation Block
Your IP or domain has a low reputation score at Yahoo. Review your list hygiene, authentication records, and spam complaint rate.

Yahoo Sender Hub Requirements

Yahoo (along with Google) updated its bulk sender requirements in 2024. To maintain good deliverability to Yahoo and AOL mailboxes:

  • Authenticate mail with SPF and DKIM aligned to your sending domain
  • Publish a DMARC policy (at minimum p=none)
  • Keep spam complaint rates below 0.3%
  • Implement one-click unsubscribe for marketing and subscription mail
  • Send only to users who have explicitly opted in
📖 Yahoo Sender Hub →

Frequently Asked Questions

Common questions about Yahoo and AOL SMTP errors.

[TSS] codes — TSS02, TSS04, TSS05, TSS07 — are the current Yahoo / AOL identifiers, used since Yahoo consolidated its mail infrastructure. [TS] codes — TS02, TS06 — are the older format. Both mean the same things; which one you see depends on which Yahoo mail cluster handled your connection. When in doubt, treat them identically.

Yahoo is a bit sneaky about this: it often uses a 421 (temporary deferral) instead of a 550 (permanent block) as its first response to a suspicious sender. The idea is to make your mail server retry, which gives Yahoo a chance to watch your sending pattern over time. If you keep triggering their filters, those 421s can eventually harden into permanent blocks. Your mail server handles 421s automatically, so you may not notice them unless you check your logs.

Head to senders.yahooinc.com — this is Yahoo's Sender Hub for exactly this situation. Registering for their feedback loop is the most important step: it shows you which of your messages Yahoo users are marking as spam, so you can fix the root cause rather than just waiting. There is also a complaint form on the same site for urgent unblock requests.

Yes, and Yahoo was actually one of the very first major providers to go all-in on DMARC. Yahoo's own domains (yahoo.com, aol.com) have had a p=reject DMARC policy for years, which is why you cannot spoof a Yahoo address. For mail arriving in Yahoo inboxes, Yahoo enforces the DMARC policy set by the sending domain — so if your domain has p=reject and your message fails DMARC, Yahoo will reject it.

🔍

Got a Yahoo bounce to decode?

Paste your full NDR email or SMTP error line for an instant plain-English diagnosis.

Open the Bounce Decoder →