Errors

Arawa Mail returns JSON error responses.

Authentication Errors

Missing or invalid API keys return 401.

{
  "statusCode": 401,
  "message": "API key is invalid",
  "name": "invalid_api_key"
}

Validation Errors

Invalid request bodies return validation errors from Laravel with status 422.

Common validation failures include:

• Missing from.
• Missing to.
• Missing both html and text.
• Invalid base64 attachment content.

Authorization Errors

Domain authorization failures return 403.

These happen when:

• The sending domain is not registered for the account.
• The API key is restricted to another domain.
• Outbound email is not enabled for the domain.

Rate Limits

Too many send attempts can return 429.