Error Codes for WhatsApp

If there is an issue in the WhatsApp message you sent, error codes are displayed to indicate the problem. You can find a list of all the error codes along with their meanings/descriptions here which help you to correct them.
You can check the errors of the failed WhatsApp messages in the logs and failed logs section of the WhatsApp section.
Error codes by Meta 
​
​If your WhatsApp vendor is Meta, please check its error codes here -
https://developers.facebook.com/docs/whatsapp/on-premises/errors
Error Code
Meaning
Possible Reasons
Suggested Fix
130472
“User’s number is part of an experiment” — the message was not sent because the recipient is in a Meta experiment group. 
Meta is running a marketing-message experiment (affects ~1% of users) and your message to that user is blocked. 
• Ask the user to initiate a new conversation (user message → you reply) to open the 24-hour window. • Use alternate channel (SMS/email) for that user. • Recognize that this is not about your template being wrong—it’s about the recipient being in the experiment.
131026
“Message Undeliverable” — recipient cannot receive the message. 
• Recipient’s phone number is not a WhatsApp account. • Recipient hasn’t accepted latest WhatsApp terms or has outdated version. • Recipient has blocked your business or number. 
• Validate phone number before sending. • Ask recipient to update WhatsApp app and accept terms. • Remove or suppress numbers that consistently return this error.
131048
“Spam rate limit hit” — your phone number has restrictions due to previous flags/low message quality. 
• Many previous messages were blocked, marked spam or unsubscribed. • Your account or phone number quality rating dropped (yellow/red). • You exceeded allowed conversation limits for your phone number. 
• Check your quality status in WhatsApp Manager: aim for green. • Reduce sending volume, ensure opt-in, personalise templates. • Segment sends; stagger campaigns rather than blasting all at once. • If needed, contact Meta support for limit increase after improving quality.
131049
“Message not delivered to maintain healthy ecosystem engagement” — too many marketing messages to this user across businesses. 
• The recipient has already received many marketing messages from businesses in a given timeframe. • Meta applies frequency cap across users to maintain ecosystem health. 
• For that user: wait before sending another marketing message. • If your message is “utility” (non-marketing) it may bypass this cap. • Improve targeting: only send to users who expect/opt-in. • Use higher-value or personalised messages rather than generic blasts.
Error codes by 360 Vendor
​
If your WhatsApp vendor is 360, please check its error codes here -
https://docs.360dialog.com/whatsapp-api/api-error-message-list
Check your Error Codes

https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/

Error codes generated by MSG91 side -
1. 400 - Invalid Request Error
Invalid JSON in request
Integrated number not found in request
Content type not found in request
There is no subscription assigned to this number
Payload not found in request
The recipient number is not found in the request
Text not found in request
The attachment URL is not found in the request
File format not supported
Invalid content type in the request
Key is missing
2. 404 - Not Found Error
WhatsApp not integrated
3. 500 - Internal Server Error
​

Error Code	Meaning	Possible Reasons	Suggested Fix
130472	“User’s number is part of an experiment” — the message was not sent because the recipient is in a Meta experiment group.	Meta is running a marketing-message experiment (affects ~1% of users) and your message to that user is blocked.	• Ask the user to initiate a new conversation (user message → you reply) to open the 24-hour window. • Use alternate channel (SMS/email) for that user. • Recognize that this is not about your template being wrong—it’s about the recipient being in the experiment.
131026	“Message Undeliverable” — recipient cannot receive the message.	• Recipient’s phone number is not a WhatsApp account. • Recipient hasn’t accepted latest WhatsApp terms or has outdated version. • Recipient has blocked your business or number.	• Validate phone number before sending. • Ask recipient to update WhatsApp app and accept terms. • Remove or suppress numbers that consistently return this error.
131048	“Spam rate limit hit” — your phone number has restrictions due to previous flags/low message quality.	• Many previous messages were blocked, marked spam or unsubscribed. • Your account or phone number quality rating dropped (yellow/red). • You exceeded allowed conversation limits for your phone number.	• Check your quality status in WhatsApp Manager: aim for green. • Reduce sending volume, ensure opt-in, personalise templates. • Segment sends; stagger campaigns rather than blasting all at once. • If needed, contact Meta support for limit increase after improving quality.
131049	“Message not delivered to maintain healthy ecosystem engagement” — too many marketing messages to this user across businesses.	• The recipient has already received many marketing messages from businesses in a given timeframe. • Meta applies frequency cap across users to maintain ecosystem health.	• For that user: wait before sending another marketing message. • If your message is “utility” (non-marketing) it may bypass this cap. • Improve targeting: only send to users who expect/opt-in. • Use higher-value or personalised messages rather than generic blasts.