• 228 destinations
  • No KYC, ever
  • Bitcoin, Monero, USDT and 4 more

API and integration

Test key (sandbox)

A test key is an API credential that accepts, validates and prices requests exactly like a live key but never sends a message or bills the balance, so an integration can be built before any money is deposited.

A test key gives an integration somewhere safe to fail. Requests made with it go through the same validation and pricing as live traffic and get responses of the same shape, so request formats, error handling, retries and webhook processing can all be exercised without consequences. The best sandboxes differ from production in exactly one respect, the send, and make that difference explicit with a status of their own rather than pretending a message was delivered.

A test key proves the integration, not the route. Whether messages reach handsets, how fast, under which sender and how the text renders on a phone only show with live traffic. The usual sequence is a test key for development and automated tests, then a few live messages to your own phones, then production. Keeping test and live keys in separate environments, and branching on the status in code, stops test results from leaking into real records.

It is also the honest form of free trial: nothing is given away, and nothing is faked.

Example

A hypothetical developer builds a sign-up code flow on a staging server with a test key. Each request returns a message id, the price and the segment count, with the status test; invalid numbers fail with the same errors live traffic would get; signed webhooks reach her staging endpoint, so the signature check is tested too. Going live means changing one configuration value.

Common mistakes

  • Recording test messages as delivered in your own database.
  • Using a live key in automated tests.
  • Treating a clean test run as proof of deliverability to a country.

At SMSMeteor: every account has an sk_test_ key. Requests made with it are validated, priced and answered with the status test; nothing is sent, nothing is charged, and webhooks still fire, signed like live ones. The panel can also send a test event of any type to your endpoint. Integrating without spending walks through the approach; see also the quickstart.

Go further

See the term in practice.An email address opens the account, the rate card is public, payment is crypto, the test key is free.
Start sending