>_SMTPBoxDOCUMENTATION

SMTPBox API errors and HTTP status codes

Understand authentication failures, permissions, validation errors, rate limits and email wait timeouts.

12 / API ERRORS

HTTP status and error codes

400invalid_json

The body is not valid JSON.

401unauthorised

The Bearer key is missing, invalid or revoked.

403forbidden

The key does not have the required write permission.

404*_not_found

The resource is missing or belongs to another workspace.

408wait_timeout

No matching message arrived; this is often a valid test failure.

413payload_too_large

The API request body exceeds 1 MB.

422validation_failed

A required field is missing or invalid.

429rate_limit_exceeded

The hourly API allowance was reached.

Error response
{
  "success": false,
  "error": {
    "code": "wait_timeout",
    "message": "No matching message arrived before the timeout."
  }
}

Updated