Sandbox

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#

ScopeSandbox is switched on per link. Each link is identified by its name, with its number and short id shown alongside.
DeliveryMessages are really delivered through WhatsApp, so you can confirm the full path to a real phone.
RecipientsOnly the link’s test numbers are accepted. Any other to is rejected.
QuotaSandbox sends do not count toward your message allowance.
CapUp to 10 messages per 24 hours for each sandbox link.

Turn sandbox on#

  1. Open the Developer page (log in first) and find the Sandbox mode section.
  2. Switch on Sandbox mode for the link you want to test, then press Save sandbox settings and confirm the prompt.
  3. Press Test message. Enter the recipient number and a message, then send.
  4. Watch the log inside the pop-up: it shows the result and how many test messages are left for the day.
Turning sandbox on stops the link delivering to anyone but its test numbers, so any production system using the same link will stop working until you turn sandbox off.

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://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#

MessageWhat 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 hoursWait 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#

  1. Switch Sandbox mode off for the link and save.
  2. The same link and token now deliver to any number.
  3. Sends count toward your message allowance again.
Sandbox is for testing only. Turn it off before production traffic, because it refuses any recipient that is not a test number.

© 2026 WaCentra Connect API. All rights reserved.