Server-side SDKs

Official Telnyx SDKs provide language-native clients for the REST API with typed models, pagination, retries, timeouts, structured errors, and webhook-signature verification.

QUICKSTART

Install an SDK and make a request

Choose a language. Every example reads the API key from TELNYX_API_KEY.Full guides: TypeScript · Python · Go · Java · Ruby · PHP

Install

npm install telnyx

First request

import Telnyx from "telnyx";

const client = new Telnyx({
  apiKey: process.env.TELNYX_API_KEY,
});

const call = await client.calls.dial({
  connection_id: "YOUR_CONNECTION_ID",
  from: "+18005550101",
  to: "+18005550102",
});

Package · Source · Releases

Open TypeScript SDK

Continue with authentication, requests, errors, pagination, and webhooks.

Browse TypeScript methods

Find an SDK method by product or REST operation.

Install

pip install telnyx

First request

import os
from telnyx import Telnyx

client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))
call = client.calls.dial(
    connection_id="YOUR_CONNECTION_ID",
    from_="+18005550101",
    to="+18005550102",
)

Package · Source · Releases

Open Python SDK

Continue with authentication, requests, errors, pagination, and webhooks.

Browse Python methods

Find an SDK method by product or REST operation.

Install

go get github.com/team-telnyx/telnyx-go/v4

First request

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go/v4"
  "github.com/team-telnyx/telnyx-go/v4/option"
)

func main() {
  client := telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY")))
  call, err := client.Calls.Dial(context.TODO(), telnyx.CallDialParams{
    ConnectionID: "YOUR_CONNECTION_ID",
    From: "+18005550101",
    To: "+18005550102",
  })
  if err != nil { panic(err) }
  fmt.Printf("%+v\n", call)
}

Package · Source · Releases

Open Go SDK

Continue with authentication, requests, errors, pagination, and webhooks.

Browse Go methods

Find an SDK method by product or REST operation.

InstallAdd com.telnyx.sdk:telnyx using the current version from Maven Central.First request

import com.telnyx.sdk.TelnyxClient;
import com.telnyx.sdk.TelnyxClientImpl;
import com.telnyx.sdk.models.calls.actions.DialParams;

TelnyxClient client = TelnyxClientImpl.fromEnv();
var call = client.calls().actions().dial(DialParams.builder()
    .connectionId("YOUR_CONNECTION_ID")
    .from("+18005550101")
    .to("+18005550102")
    .build());

Package · Source · Releases

Open Java SDK

Continue with authentication, requests, errors, pagination, and webhooks.

Browse Java methods

Find an SDK method by product or REST operation.

Install

bundle add telnyx

First request

require "telnyx"

client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])
call = client.calls.dial(
  connection_id: "YOUR_CONNECTION_ID",
  from: "+18005550101",
  to: "+18005550102"
)

Package · Source · Releases

Open Ruby SDK

Continue with authentication, requests, errors, pagination, and webhooks.

Browse Ruby methods

Find an SDK method by product or REST operation.

Install

composer require telnyx/telnyx-php

First request

$client = new Telnyx\Telnyx(
    apiKey: getenv("TELNYX_API_KEY")
);

$call = $client->calls->dial([
    "connection_id" => "YOUR_CONNECTION_ID",
    "from" => "+18005550101",
    "to" => "+18005550102",
]);

Package · Source · Releases

Open PHP SDK

Continue with authentication, requests, errors, pagination, and webhooks.

Browse PHP methods

Find an SDK method by product or REST operation.

Explore SDK documentation

TypeScript and Node.js

Typed TypeScript client for Node.js, Bun, and compatible runtimes.

Python

Synchronous and asynchronous clients with typed models.

Go

Go module with request options, typed unions, and context support.

Java

Synchronous and asynchronous Java and Kotlin-compatible clients.

Ruby

Ruby client with model helpers and Sorbet types.

PHP

PHP client with named parameters and value objects.

The Telnyx CLI provides command-line access to the same API for terminal workflows and automation.

SDK or direct HTTP

Use case	Recommended interface
Application or service integration	SDK
Typed request and response models	SDK
Pagination, retries, and structured errors	SDK
Quick endpoint test	API reference HTTP example
Shell or automation workflow	Telnyx CLI or direct HTTP
Unsupported runtime	Direct HTTP

Every REST endpoint remains available over HTTPS. The API reference provides endpoint schemas and runnable examples for direct HTTP requests.

Build with AI tools

Telnyx MCP server — connect AI assistants and agent frameworks to the Telnyx API so they can explore endpoints and make requests during SDK integration. See Local MCP server and Remote MCP server.
Agent-readable documentation — llms.txt indexes the full documentation set for LLM context loading, and the API reference carries runnable samples for the official SDKs on every endpoint page.

Coverage and release cadence

Telnyx generates the server-side SDKs from the public REST API definition. Resource and method names follow the API model, while each library retains language-specific types and conventions. SDK releases can follow REST API changes at different times. Before adopting a newly released endpoint or field:

Update to the current package release.
Confirm the generated method and model in the language resource map.
Use direct HTTP when an API capability is available before the matching SDK release.

Get help

Report SDK defects in the corresponding GitHub repository. For account or API behavior issues, contact Telnyx Support. Include the SDK language, package version, affected resource or method, and a minimal reproduction with credentials removed.

Account setup

APIs fundamentals

Server-side SDKs

Telnyx CLI

Development Tools

Migration Guides

Glossary

For AI Agents

Server-side SDKs

Install an SDK and make a request

Open TypeScript SDK

Browse TypeScript methods

Open Python SDK

Browse Python methods

Open Go SDK

Browse Go methods

Open Java SDK

Browse Java methods

Open Ruby SDK

Browse Ruby methods

Open PHP SDK

Browse PHP methods

Explore SDK documentation

TypeScript and Node.js

Python

Go

Java

Ruby

PHP

SDK or direct HTTP

Build with AI tools

Coverage and release cadence

Get help

​Install an SDK and make a request

Open TypeScript SDK

Browse TypeScript methods

Open Python SDK

Browse Python methods

Open Go SDK

Browse Go methods

Open Java SDK

Browse Java methods

Open Ruby SDK

Browse Ruby methods

Open PHP SDK

Browse PHP methods

​Explore SDK documentation

TypeScript and Node.js

Python

Go

Java

Ruby

PHP

​SDK or direct HTTP

​Build with AI tools

​Coverage and release cadence

​Get help

Install an SDK and make a request

Explore SDK documentation

SDK or direct HTTP

Build with AI tools

Coverage and release cadence

Get help