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:
1
{
2
"meta": {
3
"httpCode": 403,
4
"developerMessage": "This URL *** is blocked. More info: https://docs.360dialog.com/whatsapp-api/whatsapp-api",
5
"success": false
6
}
7
}
Copied!
What to do: Get in touch with our Support team and let us know what you are trying to achieve / describe your use case. If possible, we will enable the API for you.

2. Type: Invalid API Key

Error code: 401
Description: Invalid API key
Payload:
1
{
2
"meta": {
3
"httpCode": 404,
4
"developerMessage": "Invalid api_key or token expired",
5
"success": false
6
}
7
}
Copied!

3. Type: WhatsApp Business API has been disabled

Error code: 400
Description: Response returned if WhatsApp Business API has been disabled.
Payload:
1
{
2
"meta": {
3
"httpCode": 400,
4
"developerMessage": "Your WhatsApp for Business API has been disabled. If you believe this is a mistake, please contact our support team.",
5
"success": false
6
}
7
}
Copied!

4. Type: Usage Limit

Error code: 400
Description: Endpoint calls limits has been exceeded.
Payload:
1
{
2
"meta": {
3
"httpCode": 400,
4
"developerMessage": "You have exceeded the limit of 1 request every * seconds. Try again later.",
5
"success": false
6
}
7
}
Copied!

5. Type: Internal Server Error

Error code: 500
Description: Unknown system error.
Payload:
1
{
2
"meta": {
3
"httpCode": 500,
4
"developerMessage": "Internal server error",
5
"success": false
6
}
7
}
Copied!
The application may restart every 24h at a time that cannot be scheduled and take up to 10 minutes max. In case you need higher fail-safety, we offer upgrades to Multi Core and/or High Availability setups.
For technical help contact our support, for pricing help contact your sales agent at 360dialog by e-mail.

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:
1
{
2
"meta": {
3
"httpCode": 502,
4
"developerMessage": "WhatsApp for Business API not available.",
5
"success": false
6
}
7
}
Copied!