Keys / Telnyx

TELNYX_API_KEY

The API key your server calls the Telnyx REST API with, sent as a Bearer token.

Expires
you choose a date, or no expiration
API
none for existing accounts; Mission Control Portal only

Get it

Create one on portal.telnyx.com. The steps aren't recorded yet.

Set it

TELNYX_API_KEY=...

The Node.js, Python, Go, Ruby and PHP SDKs read it when you don't pass a key. The Java SDK reads it only through TelnyxOkHttpClient.fromEnv(). Or keep it out of .env with keypin: keypin run -- npm run dev

Replace it

  1. On the API Keys page, click Create API Key. If the old key has an expiration date, do this before it passes.
  2. Deploy it everywhere that reads TELNYX_API_KEY, and confirm a read-only request works. Both keys work in the meantime.
  3. Check that nothing still uses the old key, then revoke it on the same page.

Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.

Sources, checked 2026-11-16