Error Messages
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/whatsapp-api/whatsapp-api",
"success": false
}
}
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.
Error code: 401
Description: Invalid API key
Payload:
{
"meta": {
"httpCode": 404,
"developerMessage": "Invalid api_key or token expired",
"success": false
}
}
What to do: Generate another API key
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
}
}
What to do: If you expected the account to be live, please contact our support team.
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
}
}
What to do: Means you are trying to make too many calls in too little time. See Capacity Rate Limits for more information.
Error code: 500
Description: Regular accounts can restart every 24h at a time that cannot be scheduled. These restarts take a maximum of 10 minutes.
Payload:
{
"meta": {
"httpCode": 500,
"developerMessage": "Internal server error",
"success": false
}
}
What to do: If you are receiving this error for more than 10 minutes, please contact our support team. If you want to avoid these restarts, please consider upgrading the account to the Premium Package.
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
}
}
What to do: Check this account's status to ensure it is running.
Error code: 403
Description: This means that the authorization used is not valid for this request.
Payload:
{
"meta": {
"success": false,
"http_code": 403,
"developer_message": "Permission denied for partner 'PARTNERID'"
}
}
What to do:
- 1.
- 2.
- 3.Check if the credentials used are correct
These always have the code 403 and are described as Trigger registration error.
Error code: 1005
Description: This means that Meta has put the registration on "timeout".
Payload:
{
"data": {
"code": 1005,
"details": "Please wait 1 hour(s) 38 minute(s) before trying again",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}
What to do: Wait until the timeout phase has lapsed and try again.
Error code: 1005
Description: This means the previous WhatsApp installation was uninstalled from the device but not fully deleted.
Payload:
{
"data": {
"code": 1005,
"details": "Unknown error: biz_link_info_invalid_payload",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}
What to do: In the device running the WhatsApp App the number was previously registered in, reinstall WhatsApp and then fully delete it.
Error code: 1005
Description: This means the previous WhatsApp installation was not deleted.
Payload:
{
"data": {
"code": 1005,
"details": "This number has not been approved for an enterprise. Please contact support for more info.",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}
What to do: In the device running the WhatsApp App the number is registered fully delete the account and app.
Error code: 1005
Description: This means that the registration has been locked.
Payload:
{
"data": {
"code": 1005,
"details": "There was an error verifying this phone number.Please try again later.",
"title": "Access denied"
},
"meta": {
"developer_message": "Trigger registration error",
"http_code": 403,
"success": false
}
}
What to do: Please contact our support team and we will reset the registration state.
400: Bad Request
Check that you are using the correct data type for Booleans and Strings, and that the JSON-payload is well-formed. Use an online tool (ex. JSON formatter and validator) to validate the payload if you are not sure.

Booleans don't need double quotes!
408: Message failed to send because it was pending for too long
There are no further details provided by WhatsApp. The recommendation is to resend the message.
470: Message failed to send because more than 24 hours have passed since the customer last replied to this number (no open session)
Free-form text messages and media messages will result in a failure callback with error 470 when sent outside of the 24h-window. In other words, if it has been more than 24 hours since you last received a user initiated message - the session is closed and you can no longer use free-form messages. Please find a way to restrict message sending if there was no incoming message for the given user/phone number within 24h. Alternatively, you can contact the user using a Template Message.
1000: Failed to generate processed file path
This could occur when the file storage is full and files cannot be stored. Please reach out to Help and Support.
1000: Image file format (audio/mpeg) is not supported
Make sure that the message type matches the MIME-type of the file (ex. audio files should be sent using "audio", not "image";
audio/mpeg
is an unsupported combination).
Another reason could be that the video file doesn't have an audio track: then the error message contains something like video/mp4/h264/NONE
where NONE is an indicator that the audio track is missing.
1006 - Unknown contact
You did not use the v1/contacts endpoint to get a valid wa_id before sending the message. See the above guide on how to use the v1/contacts endpoint.
1009: Invalid latitude
The valid range is from -90 to 90.
1014: Request for .... failed
You have provided a URL that seems to be double URL-encoded and the file cannot be delivered because of that, or the file behind the URL doesn't exist.
2001: Template name does not exist in the translation
The template needs to be set up by our Support team.
500: structure unavailable: Client could not display the highly structured message (hsm)
The Template was not understood by the WhatsApp consumer client. Check the format.
Last modified 5mo ago