API Error Messages

List of common API errors you might encounter.

1. Type: The Path is Blocked

Error code: 403

Description: Response returned if path is blocked.

Payload:

{
"meta": {
"httpCode": 403,
"developerMessage": "This URL *** is blocked. More info: https://docs.360dialog.com/api/whatsapp-api",
"success": false
}
}

2. Type: Invalid API Key

Error code: 401

Description: Invalid API key

Payload:

{
"meta": {
"httpCode": 404,
"developerMessage": "Invalid api_key or token expired",
"success": false
}
}

3. Type: WhatsApp Business API has been disabled

Error code: 400

Description: Response returned if WhatsApp Business API has been disabled.

Payload:

{
"meta": {
"httpCode": 400,
"developerMessage": "Your WhatsApp for Business API has been disabled. If you believe this is a mistake, please contact our support team.",
"success": false
}
}

4. Type: Usage Limit

Error code: 400

Description: Endpoint calls limits has been exceeded.

Payload:

{
"meta": {
"httpCode": 400,
"developerMessage": "You have exceeded the limit of 1 request every * seconds. Try again later.",
"success": false
}
}

5. Type: Internal Server Error

Error code: 500

Description: Unknown system error.

Payload:

{
"meta": {
"httpCode": 500,
"developerMessage": "Internal server error",
"success": false
}
}

6. Type: WhatsApp for Business API not available.

Error code: 502

Description: Error returned if integration with WhatsApp Business does not exist in system or integration is not in running state (WhatsApp Business stack is not running).

Payload:

{
"meta": {
"httpCode": 502,
"developerMessage": "WhatsApp for Business API not available.",
"success": false
}
}