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

API and integration

API key

An API key is the secret credential that identifies an account to the SMS API; it is sent as a bearer token, scoped to what it may do, and should be created per system and revoked when exposed.

An API key is a password for software: a long random string that identifies the account and carries a set of permissions. Unlike a person's password it is used by machines, without a second factor, so its protection rests on how it is issued, stored and limited. A sound implementation shows the key once at creation and keeps only a hash, lets you scope it to what it may do, can tie it to an IP allowlist and revokes it instantly. A recognisable prefix, such as one marking live or test keys, helps people and secret-scanning tools spot a key that has leaked into a repository or a log.

The working rule is one key per system and environment, with the smallest scope that works. Keys belong in environment variables or a secrets manager, never in client-side code, a mobile app or source control. Rotation is routine: create the new key, deploy it, revoke the old one. A leak is handled the same way, immediately.

Example

A hypothetical company runs a checkout service that only sends codes and a reporting job that only reads statuses. The checkout service gets a live key scoped to sending and allowlisted to its two servers; the reporting job gets a read-only key; staging uses a test key. When the reporting key turns up in a public log, it cannot send a single message, and replacing it touches one system.

Common mistakes

  • Shipping the key inside a web page or an app, where anyone can extract it.
  • Sharing one key across every system, so that a leak means rotating everywhere.
  • Logging full request headers, which writes the key into log files.
  • Running automated tests with a live key.

At SMSMeteor: keys are created in the panel, shown once, and sent as bearer tokens with an sk_live_ or sk_test_ prefix. They are scoped to send, read or both, and a key may carry an IP allowlist; requests from other addresses receive 401 unauthorized. Test keys validate, price and answer like live ones, return the status test, and never send or bill. See also the security page.

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