WhatsApp 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 for Business API has been disabled
Error code: 400
Description: Response returned if WhatsApp for 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 for Business not exists in system or integration is not in running state (WhatsApp for Business stack is not running).
Payload: 
{
    "meta": {
        "httpCode": 502,
        "developerMessage": "WhatsApp for Business API not available.",
        "success": false
    }
}
Migration from old API
Next - 360dialog API Reference
WhatsApp Template Messaging
Last updated 1 month ago