Skip to content

Overview

Every Teler account has two modes:

  • Sandbox: for building and testing. Calls use the sandbox numbers assigned to your account at signup and are limited to verified numbers, so you can test end to end before going live.
  • Production: for production traffic on your virtual numbers.

In the Teler dashboard, switch between sandbox and production mode from the mode dropdown. Everything you see and create in the dashboard (Call logs, Voice apps, SIP trunks, and so on) belongs to the mode that is currently selected.

Each account has one API key per mode. The key you send in the X-API-Key header decides which mode the request runs in:

ModeAPI key
SandboxTest API key
ProductionLive API key

See Authentication for where to find the keys and how to store them.

Webhook events on the 2026-06-01 version carry a mode field (sandbox or live) in the event envelope, so one endpoint can tell the two apart.

Sandbox and live data are kept separate. Only account-level data is common to both modes:

Common to both modesSeparate in each mode
UsersCall logs
SettingsWebhook event logs
CreditsVoice apps
SIP trunks
App secrets
IP ACLs
Virtual numbers
SandboxLive
API keyTest API keyLive API key
Phone numbersSandbox reference number and sandbox virtual number, assigned at signupObtained virtual numbers (paid)
Who you can call / who can call youVerified numbers onlyAny number
Inbound callsCaller enters a 4-digit sandbox PIN for the Voice App or SIP Trunk they want to reachRouted directly