Sandbox mode
Test your integration end to end before going live. A sandbox link delivers real WhatsApp messages, but only to numbers you list as test numbers, and never touches your package message allowance.
How sandbox works#
| Scope | Sandbox is switched on per link. Each link is identified by its name, with its number and short id shown alongside. |
|---|---|
| Delivery | Messages are really delivered through WhatsApp, so you can confirm the full path to a real phone. |
| Recipients | Only the link’s test numbers are accepted. Any other to is rejected. |
| Quota | Sandbox sends do not count toward your message allowance. |
| Cap | Up to 10 messages per 24 hours for each sandbox link. |
Turn sandbox on#
- Open the Developer page (log in first) and find the Sandbox mode section.
- Switch on Sandbox mode for the link you want to test, then press Save sandbox settings and confirm the prompt.
- Press Test message. Enter the recipient number and a message, then send.
- Watch the log inside the pop-up: it shows the result and how many test messages are left for the day.
Test numbers#
The Test message pop-up is the only place numbers are entered. It is prefilled with your saved test number, or the link’s own number. Test numbers are saved to the link, and a sandbox link only accepts sends to those numbers.
Use international format, digits only or with a leading + — both match the same number.
Sending through the API#
Your integration code does not change. Call the normal send endpoint with the same link API key; the link’s sandbox setting decides the behaviour.
curl -X POST https://www.wacentraconnectapi.com/api/v1/sessions/SESSION_UUID/messages \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"to": "+254700000000", "text": "Hello from the sandbox"}'
A successful send returns the same response shape as production. Messages are flagged as sandbox in your history and request logs.
Errors and limits#
| Message | What to do |
|---|---|
| Sandbox mode is on. Add a test number… | Send a test from the Developer page first so a test number is saved. |
| You can only send to your sandbox test number(s) | Use a saved test number, or turn sandbox off to message other contacts. |
| Sandbox limit reached: 10 test messages per 24 hours | Wait for the 24-hour window to free up, or turn sandbox off for real traffic. |
| The message could not be delivered… | Check that the link’s WhatsApp connection is active. The failure reason is logged on the message. |
These come back as 422 with an errors object, like any validation error.
What is locked in sandbox#
While sandbox is on, credentials, webhook settings and API token generation for the link are locked, so a test link cannot be mistaken for a production one. Turn sandbox off on the Developer page to change them.
Going live#
- Switch Sandbox mode off for the link and save.
- The same link and token now deliver to any number.
- Sends count toward your message allowance again.
© 2026 WaCentra Connect API. All rights reserved.