Skip to main content

How do enhanced status codes (X.Y.Z) work?

Enhanced status codes provide detailed diagnostic information:

  • Format: X.Y.Z
  • X (Class): 2=Success, 4=Temporary failure, 5=Permanent failure.

Y (Subject): 0=Other, 1=Addressing, 2=Mailbox, 3=Mail system, 4=Network, 5=Protocol, 6=Content, 7=Security.

Z (Detail): Specific condition within the subject category.

Common examples:

5.1.1: Bad destination mailbox address. 5.2.2: Mailbox full. 5.7.1: Delivery not authorized, message refused. 4.7.0: Temporary authentication failure.

Usage:

Appear alongside or after basic SMTP codes. Provide machine-readable detail. Enable more precise bounce classification.

Enhanced codes are the fine print. They tell you exactly what went wrong beyond the headline.

Need personalized help?

Master enhanced status codes and fix rejections faster. Open an AI assistant with your question pre-loaded — just add your details and send.