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
- On the API Keys page, click Create API Key. If the old key has an expiration date, do this before it passes.
- Deploy it everywhere that reads
TELNYX_API_KEY, and confirm a read-only request works. Both keys work in the meantime. - 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
- Telnyx: Create and manage API keys
- Telnyx: API authentication
- Telnyx: auth.md
- Telnyx OpenAPI spec
- telnyx-node: reads TELNYX_API_KEY
- telnyx-python: reads TELNYX_API_KEY
- telnyx-go: reads TELNYX_API_KEY
- telnyx-java: reads TELNYX_API_KEY
- telnyx-ruby: reads TELNYX_API_KEY
- telnyx-php: reads TELNYX_API_KEY
- telnyx-java: ClientOptions.fromEnv