Errors

Errors return a consistent JSON envelope so SDKs and clients can branch on error.type.

Error format

{
  "error": {
    "type": "validation_error",
    "message": "Invalid to address",
    "detail": "to[0] is not a valid email",
    "field": "to"
  }
}

Error types

The type enum includes:

• validation_error
• not_found
• rate_limited
• domain_not_verified
• unauthorized
• forbidden
• conflict
• payment_required
• suppressed_recipient
• internal_error
• idempotency_conflict

HTTP status codes