---
id: telnyx
version: "4.173.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# telnyx — The official Python library for the telnyx API

License: permissive · Maintenance: active · Downloads: 720.5K/mo

## What it is and what it does

Telnyx is the official Python SDK for the Telnyx communications platform REST API. It wraps HTTP calls to Telnyx's endpoints with a typed, object-oriented interface, supporting both synchronous and asynchronous workflows. The library is generated using Stainless and includes full type hints for all request parameters and response fields, enabling IDE autocomplete and static type checking.

The package is built on httpx for HTTP transport and pydantic for response validation. It handles pagination automatically, provides helper methods for serializing responses to JSON or dictionaries, and includes error classes for connection and API status failures. Async usage is identical to sync except for await keywords; you can optionally swap httpx for aiohttp as the HTTP backend for improved concurrency performance.

Use it for:

- Programmatically dial phone calls, manage connections, and configure answering machine detection in voice applications.
- Build IVR systems or contact center integrations that need to interact with Telnyx's telephony platform.
- Transcribe audio files or access AI-powered communication features via the Telnyx API.
- Manage phone numbers, access IP addresses, and handle number orders through the REST API.
- Integrate Telnyx webhooks and event handling into async Python applications with type safety.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python client library for the Telnyx REST API, offering both synchronous and asynchronous interfaces with full type definitions for requests and responses.

Yes. The library is actively maintained, has no known vulnerabilities, uses permissive MIT licensing, and offers low install friction. It is the official Telnyx SDK with full type support and both sync/async interfaces—the right choice for any Python application integrating Telnyx communications services.

## Install

pip install telnyx
uv add telnyx
poetry add telnyx

## Installing telnyx

Before you install: Low install friction with a pure-Python wheel and six common dependencies (anyio, distro, httpx, pydantic, sniffio, typing-extensions). Actively maintained with a release 2 days old and recent commits.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this library freely provided you include the license notice.

Quickstart:

pip install telnyx

import os
from telnyx import Telnyx

client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))
response = client.calls.dial(
    connection_id="conn12345",
    from_="+15557654321",
    to="+15551234567",
    webhook_url="https://your-webhook.url/events",
)
print(response.data)

Requires Python 3.9 or later; TELNYX_API_KEY environment variable or explicit api_key parameter needed to authenticate.

Verify before relying:

- Whether the library's auto-pagination handles all edge cases and rate-limiting scenarios reliably.
- Performance characteristics when handling large concurrent requests with the async client.
- Completeness of type coverage across all Telnyx API endpoints and response schemas.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 720.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

telnyx api client, python telephony sdk, voice call api library, async http client, rest api wrapper, typed api client, communications platform sdk, communications-api, async-ready, typed

[View on SkillFed](https://skillfed.io/packages/telnyx) · [View on PyPI](https://pypi.org/project/telnyx/)