Skip to main content

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

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"
}