Response Codes

Status Codes

Status CodeDescription
202Accepted: Email Request is accepted for processing
200OK: (For Sandbox mode)
400Bad Request: Invalid request data
401Unauthorized: Invalid product token
403Forbidden: Email rejected (size/content)
500Internal Server Error: Server-side error

Responses

All responses follow a consistent format:

{
    "status": 202,
    "message": "Accepted",
    "success": true,
    "messageId": "5dcdf71f-96d6-4763-8d70-ef17d8aa6dbc"
}

Successful Response (202)

{
    "status": 202,
    "message": "Accepted",
    "success": true,
    "messageId": "5dcdf71f-96d6-4763-8d70-ef17d8aa6dbc"
}

Successful Response (200)

{
    "status": 200,
    "message": "Sandbox mode is enabled. The messages is accepted but will not be sent.",
    "success": true,
    "messageId": "df9990e2-f7cb-450d-9528-6e6698c8abab"
}

Invalid Product Token (401)

{
    "status": 401,
    "message": "Product token is mandatory.",
    "success": false,
    "messageId": ""
}

Invalid Request (400)

{
    "status": 400,
    "message": "From Address is invalid or empty",
    "success": false,
    "messageId": ""
}

Recipients Limit Exceeded (400)

{
  "status": 400,
  "message": "Recipients count exceeds the max allowed limit of 50",
  "success": false,
  "messageId": "550e8400-e29b-41d4-a716-446655440000"
}

Email Too Large (403)

{
  "status": 403,
  "message": "Email size exceeds maximum allowed size",
  "success": false,
  "messageId": "550e8400-e29b-41d4-a716-446655440000"
}

Internal Server Error (500)

{
  "status": 500,
  "message": "Internal server error occurred",
  "success": false,
  "messageId": "550e8400-e29b-41d4-a716-446655440000"
}