Articles on: API Services

Sandbox environment

The sandbox allows you to test inbound/outbound messaging without purchasing a dedicated sender name. You can use this feature to test the product or API before paying or using it in a production environment.

To use the sandbox:

1) Open Dashboard, select your organization from the list, and then in the left sidebar, choose Sandbox

2) Add a phone number or email to the sandbox contacts list. You must set a phone number or email that you set up as Start new conversation from in the Messages app. Check this article to learn more about this setting.

3) Initiate a conversation in the sandbox sender name by pressing Compose message in sandbox from your Mac or iPhone.

Once the sandbox sender receives your message, it will try to match a contact with your sandbox list. Once it's matched, this message will be assigned to your account.

Sandbox limitation

You can add up to 5 contacts to your sandbox list.
Sandbox works only with your default (first) organization in the account.
As soon as the "sandbox" receives a message from a contact and matches it to your account, it will open a 24-hour messaging window. This window resets every time you receive an inbound message from the contact.
The Sandbox cannot initiate a conversation with a random contact. For every outbound message to a new contact, that contact must first send a message to the sandbox - as confirmation that the recipient is under your management.
Group chats are not supported.

Please note: when you have finished working with a sandbox, you should remove your contacts from the sandbox list. Otherwise, all requests related to contacts in this list will be forcibly redirected to the sandbox.

Don't use sandbox messaging in a production environment or for junk. If you will abuse it, we reserve the right to restrict your sandbox access.

Updated on: 25/03/2026

Was this article helpful?

Thank you!