Errors

{ "message": "Unauthenticated" }

{
  "message": "This API key does not have the \"messages:send\" ability. Abilities are chosen when the key is minted and cannot be widened — mint a new key that includes this ability.",
  "type": "forbidden_ability",
  "required_ability": "messages:send"
}

{
  "message": "This key is bound to the Application \"legacy-mailer\", which is archived. Archived Applications accept no new sends; use a key for a live Application.",
  "type": "application_archived",
  "application": "legacy-mailer"
}

{
  "message": "This message is sealed. Revealing a sealed body is owner-only and audited, and this key was not minted by an owner — have an owner mint a read-content key, or open the message in the panel as an owner.",
  "type": "sealed_body_denied",
  "required_ability": "reveal_sealed_body"
}

{ "message": "No template with slug \"auth/password-resett\" on this account. Sync it from git or create it in the panel before sending against it." }

{ "message": "No template version with id \"999999\" on this account." }

{ "message": "No application with slug \"billing\" on this account. Create it in the panel, or omit \"application\" and use a key scoped to one." }

{ "message": "Idempotency-Key was already used with a different request body" }

{
  "message": "Content expired",
  "completed_at": null
}

{
  "message": "That report is larger than 5 MB, which no real aggregate report is.",
  "type": "report_too_large"
}

{ "message": "Template \"auth/password-reset\": missing variables: reset_url, expires_minutes" }

{ "message": "Template \"auth/password-reset\": unexpected variables: extra" }

{ "message": "Template has no published version" }

{ "message": "application is required for org-wide keys" }

{ "message": "From domain \"mail.example\" is not verified for this account. Verify it under Domains (TXT ownership), or send From an address on a domain you have already verified." }

{
  "message": "The to field must be an address, an object with an email, or a list of either.",
  "errors": {
    "to": [
      "The to field must be an address, an object with an email, or a list of either."
    ]
  }
}

{
  "message": "That cursor no longer exists — the message it points at was erased or has aged out of retention. Start the listing again without a cursor.",
  "type": "cursor_expired"
}

{
  "message": "Too many recipients in one message: 101 of a maximum 100 across to, cc and bcc.",
  "type": "limit_exceeded",
  "limit": {
    "dimension": "recipients_per_message",
    "binding": "platform",
    "lift": "Split the send into batches of 100 recipients or fewer. This ceiling is the same one the inbound SMTP shim applies.",
    "limit": 100,
    "used": 101
  }
}

{
  "message": "Application limit reached: 3 of 3 on Free. Upgrade your plan to create more applications.",
  "type": "limit_exceeded",
  "limit": {
    "dimension": "applications",
    "binding": "plan",
    "lift": "Upgrade your plan to create more applications.",
    "limit": 3,
    "used": 3
  }
}

{
  "message": "Send the report as the request body, or as a file field named \"report\". Gzip, zip and plain XML are all accepted.",
  "type": "empty_report"
}

{
  "message": "Refusing a DMARC report containing a document type declaration.",
  "type": "unreadable_report"
}

{
  "message": "That cursor is an integer id. This list is ordered by range_end, then id, and a cursor has to name both or a later page drops reports. Start the listing again without a cursor.",
  "type": "invalid_cursor"
}

HTTP/1.1 429 · Retry-After: 42
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0

{
  "message": "API rate limit exceeded: used 60 of 60 requests this minute. Wait for the next minute window, or raise the key/plan API rate limit.",
  "type": "limit_exceeded",
  "limit": {
    "dimension": "api_rate",
    "binding": "plan",
    "limit": 60,
    "used": 60,
    "lift": "Wait for the next minute window, or raise the key/plan API rate limit."
  }
}

HTTP/1.1 429 · Retry-After: 21600

{
  "message": "Daily send limit exceeded: plan daily send limit — used 1,000 of 1,000 recipients today. Upgrade your plan to raise the daily send cap, or wait until midnight (UTC).",
  "type": "limit_exceeded",
  "limit": {
    "dimension": "daily_send",
    "binding": "plan",
    "lift": "Upgrade your plan to raise the daily send cap, or wait until midnight (UTC).",
    "limit": 1000,
    "used": 1000
  }
}

HTTP/1.1 429 · Retry-After: 600

{
  "message": "One recipient has already received 60 messages from this account in the last hour, of a maximum 60.",
  "type": "limit_exceeded",
  "limit": {
    "dimension": "recipient_messages_per_hour",
    "binding": "account",
    "lift": "This ceiling exists to catch a retry loop, not to shape normal traffic. If an address legitimately needs more, it can be raised per account.",
    "limit": 60,
    "used": 60
  }
}

HTTP/1.1 429

{
  "message": "Content view limit reached: you have opened 20 of 20 message bodies today. It resets at midnight Europe/Kyiv. Every body opened on this account is recorded in the audit log; ask an owner to raise the per-person cap if you need more.",
  "type": "content_view_quota_exceeded",
  "limit": 20,
  "used": 20
}

HTTP/1.1 429 · Retry-After: 12

{
  "message": "Too many requests from this address. This limit is on unauthenticated traffic reaching the API, not on your account or key.",
  "type": "edge_rate_limited"
}

{
  "message": "Rate limiter unavailable — refusing request rather than bypassing the cap",
  "type": "dependency_unavailable",
  "dependency": "redis"
}

{
  "message": "Message body cannot be decrypted — the keyring is unavailable on this server. This is a platform fault, not missing content. Contact support.",
  "type": "body_unreadable",
  "reason": "decrypt"
}

{
  "message": "no_usable_transport: No transport is configured for this application, or all configured transports are disabled. Add or re-enable a transport in the panel, then retry with the same idempotency key. The message was not queued.",
  "type": "no_usable_transport",
  "last_transport_error": "connection refused to smtp.example:587"
}