SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site,, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

Troubleshooting the Twilio Sandbox for WhatsApp

The Twilio Sandbox for WhatsApp offers an easy way to try out Twilio's WhatsApp functionality for prototyping or internal testing, before you enable your own Twilio number for WhatsApp use in production. Please read on for common error messages, and how to resolve them.

Error: Your number is not associated with the Sandbox channel

This error indicates the From number you're attempting to use in your message is not associated with the Twilio Sandbox. If you haven't enabled your Twilio number for WhatsApp, you will need to use the shared Twilio Sandbox number to send and receive messages. The Sandbox number is for testing and development purposes only. This number can be found in Console's WhatsApp Sandbox.

To learn more about enabling your own Twilio number for WhatsApp, see Connect your Twilio Number to your WhatsApp Business Profile (Twilio Docs).

Error: Twilio could not find a Channel with the specified From address

This error indicates you have not yet enabled the Twilio Sandbox for WhatsApp on your project, or the From number you're attempting to use in your message is not formatted correctly.

To configure the Twilio Sandbox for WhatsApp, visit Console's WhatsApp Sandbox. Here you will find the Sandbox number, instructions to join the Sandbox with your mobile number (a requirement to send messages to that number with the Sandbox), and the message templates provided for testing with the Sandbox.

When sending WhatsApp messages via the Twilio REST API, the From address should be 'whatsapp:' followed by the Sandbox number in E.164 formatting:


For more information on configuring the Twilio Sandbox for WhatsApp, and code samples for sending message, please see Getting Started with Twilio for WhatsApp.

WhatsApp Messages are Not Delivered

For help with WhatsApp messages not being delivered, please see our article Troubleshooting Undelivered Twilio for WhatsApp Messages.

Additional Resources

Have more questions? Submit a request
Powered by Zendesk