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"
}
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"
}
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"
}
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 Priority (400)

{
    "status": 400,
    "message": "Priority must be 'low' or 'high'.",
    "success": false,
    "messageId": ""
}
status: 400
message: "Priority must be 'low' or 'high'."
success: false
messageId: ""

Invalid Product Token (401)

{
    "status": 401,
    "message": "Product token is mandatory.",
    "success": false,
    "messageId": ""
}
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": ""
}
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"
}
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"
}
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"
}
status: 500
message: "Internal server error occurred"
success: false
messageId: "550e8400-e29b-41d4-a716-446655440000"

Did this page help you?