WhatsApp Cloud API error 131030: why is the recipient not in the allowed list?
Error 131030 means you are sending from a test number to a phone number that is not on that test number’s recipient list. While you build on Meta’s test number, it can only message the numbers you added as recipients in the developer dashboard; to message anyone, connect a real business number.
If the number is on the list and the error still appears, compare the formats: the number your webhook receives and the one in the list must match digit for digit, country code included.
How it works
Check which number is sending
If the sender is Meta’s free test number, only listed recipients can receive messages from it.
Add the recipient
In the developer dashboard, add the person’s number as a recipient of the test number.
Compare the formats
Log the number exactly as the webhook delivers it and as the list stores it. One missing digit is enough for the error.
Fix the number before sending
Normalise the number in the step that sends the reply, so it matches the stored format.
Move to a real number
Once tests pass, register the business’s own number; the recipient list stops applying.
What it costs to run
Fixing this error costs nothing. What messages cost once you send from a real number is in the guide on connecting WhatsApp to an assistant.
What we learned building it
Our own fictional demo clinic, built on a Meta test number on 27 September 2026. Not a client system.
- Brazilian numbers lost their ninth digit
- Brazilian mobile numbers reached our webhook without the ninth digit (12 digits), while the recipient list stored them with it (13 digits). Every reply failed with 131030 until the sending step put the 9 back.
- A different error looks similar
- A test number on an unverified business could not deliver to Brazilian numbers at all (error 130497), even when listed. The replies were written; Meta refused delivery.
When it is not worth it
- Do not build a workaround around the test number for real customers: register the business’s number instead.
Questions
Does 131030 happen on a real business number?
The recipient list belongs to the test number. On a registered business number, a delivery failure has a different code.
Will the customer see an error?
No. Their message reached you; your reply was refused, so they simply get no answer. That is why the error matters.
Is the number format the same in every country?
No. Brazil is the case we hit: mobiles can arrive with or without the ninth digit. Normalise numbers for the countries you serve.
Sources
Want a WhatsApp assistant set up on your own number, tested before it answers anyone?
See the service: WhatsApp assistantsLet’s talkAll guides
- What should an inbound voice agent answer, and what must it hand to a person?
- What does a website chatbot do for a small business, and when is it worth it?
- How do you connect WhatsApp to an assistant with Meta's Cloud API?
- How do you automate a support inbox without sending a wrong reply?
- n8n, Zapier or Make: which one should a small business choose?
- How do you pull data out of hundreds of PDFs?
- How do you build a report that updates itself when the data changes?
- How does an internal knowledge assistant answer from your documents without making things up?
- How do you automate a content workflow and keep an editor in control?
- How do you build a sourced lead list without buying one?
- What does a small business website need to be found by Google and ChatGPT?
- When does a business need a customer portal instead of email?
- When should a business move a process off spreadsheets into an internal tool?
- Why does my n8n workflow run twice for the same thing?
- My n8n workflow worked, and now it fails with 401 or 403. Why?
- How do I find out when an n8n workflow fails silently?
- Who can fix a broken n8n workflow, and what does a repair cover?
- What must a lettings assistant never do under the Renters’ Rights Act?
- What does a WhatsApp assistant cost to run in the UK?
- Can a clinic in Dubai use an AI chatbot with patient data under UAE law?
- How much does a WhatsApp message cost in Brazil in 2026?
- What is an AI agency?
- Until what time do dental clinics in Brazil answer?
- An out-of-hours message on a clinic’s WhatsApp: templates, and what it does not solve
- An AI virtual receptionist for a dental clinic: what it does and what it does not
- Best AI receptionists for clinics in Brazil (2026)
- How do I add my business to ChatGPT?
- How do I get my business recommended by ChatGPT?
- How much should a small business budget for AI in its first year?
- How do I choose an AI agency? What to ask and the warning signs
- How to forward missed business calls to an answering line (every US carrier and phone system)
- How do I forward missed calls on Verizon to an answering line?
- How do I forward missed calls on T-Mobile to an answering line?
- How do I forward missed calls on AT&T to an answering line?
- How do I forward missed calls on AT&T Phone for Business?
- How do I forward only missed calls on an iPhone?
- How do I forward missed calls on a Samsung Galaxy or Android phone?
- Can Google Voice forward calls to an answering line?
- How do I forward missed RingCentral calls to an answering line?
- How do I forward missed calls on Comcast Business Voice to an answering line?
- How do I forward missed calls on Spectrum Business Voice to an answering line?
- How do I forward missed Dialpad calls to an answering line?
- How do I forward missed calls on Quo (formerly OpenPhone) to an answering line?
- How do I send missed Grasshopper calls to an answering line?
- How do I forward missed Vonage Business calls to an answering line?
- How do I forward missed Ooma Office calls to an answering line?
- Best AI receptionists for plumbers, HVAC and electricians in 2026