https://api.telnyx.com/v2 base URL, JSON request and response bodies, and Bearer API-key authentication unless an endpoint reference states otherwise.
Cloud Storage S3 operations, WebRTC clients, WebSocket APIs, and webhook deliveries use product-specific protocols. Follow the linked product documentation instead of applying the REST conventions on this page universally.
Start here
Complete these steps before configuring a product integration.Create an API key
Create, store, rotate, and revoke server-side credentials.
Make the first request
Validate authentication with a safe
GET /balance request.Browse the API reference
Inspect canonical endpoint contracts and language samples.
Build the integration
Authentication
Send Bearer credentials and separate REST authentication from product-specific protocols.
Requests and responses
Select methods, encode JSON, and interpret success and error envelopes.
Pagination, filtering, and sorting
Traverse collections using only the query parameters declared by each endpoint.
Errors and troubleshooting
Diagnose authentication, authorization, validation, throttling, and service failures.
Rate limits and retries
Respect response headers and retry only when the operation is safe.
Webhooks
Verify signatures, acknowledge promptly, and process duplicate deliveries idempotently.