Telnyx developer resources
Use the Telnyx REST API reference below to find endpoints, request schemas, and response examples by product.- Telnyx API Authentication: Authenticate requests with a Bearer API key.
- Telnyx OpenAPI Specification: Download the machine-readable REST API contract.
- Telnyx Developer Portal: Manage your account and API keys in Mission Control.
- Telnyx MCP Server: Connect AI agents to the remote Model Context Protocol server.
How the API works
Telnyx REST APIs use thehttps://api.telnyx.com/v2 base URL, JSON request and response bodies, and Bearer API-key authentication unless an endpoint reference states otherwise. Regional endpoints, such as https://api.telnyx.eu/v2 for Europe, serve the same API surface; see Regional endpoints & the EU PoP.
Each endpoint page in the reference is the contract for that operation: its method, path, authentication, query parameters, request body, response schema, and status codes. Many operations return a top-level data member, and collection operations can add meta pagination fields such as page_number and total_pages. Never infer that a path supports a method or a query parameter — check the endpoint page.
To get started:
- Create an API key in Mission Control Portal and keep it server-side.
- Make a first request to validate the key with a read-only
GET /balancecall. - Find the endpoints for your product in the cards below, then read Requests and responses, Pagination, filtering, and sorting, and Rate limits before going to production.
- When a request fails, use Errors and troubleshooting to diagnose authentication, validation, and throttling failures.
API reference by product
AI
Build assistants, streaming chat, speech, and embeddings with Telnyx Inference APIs.
Real-time communications
Voice, messaging, TeXML, fax, and media APIs for real-time experiences.
Numbers & identity
Search, provision, and manage phone numbers, porting, verification, and identity services.
Connectivity & networking
Wireless SIMs, private networks, WireGuard, and cross-connect APIs.
Account & billing
Billing, payments, notifications, reporting, and account management APIs.
OAuth
OAuth 2.0 endpoints for authenticating and managing access to Telnyx resources.