Server-side SDKs

QUICKSTART

Install an SDK and make a request

Create an API key, export it as TELNYX_API_KEY, then select a language. Each example performs the read-only GET /balance request and prints the response.

Install

npm install telnyx

First request

import Telnyx from "telnyx";

const client = new Telnyx({
  apiKey: process.env.TELNYX_API_KEY,
});
const balance = await client.balance.retrieve();
console.log(balance);

Continue to the TypeScript / Node.js guide · Browse TypeScript / Node.js methods

Install

pip install telnyx

First request

import os
from telnyx import Telnyx

client = Telnyx(api_key=os.environ["TELNYX_API_KEY"])
balance = client.balance.retrieve()
print(balance)

Continue to the Python guide · Browse Python methods

Install

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

First request

package main

import (
  "context"
  "fmt"

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

func main() {
  client := telnyx.NewClient()
  balance, err := client.Balance.Get(context.TODO())
  if err != nil { panic(err) }
  fmt.Printf("%+v\n", balance)
}

Continue to the Go guide · Browse Go methods

Install

implementation("com.telnyx.sdk:telnyx:6.88.0")

First request

import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;

TelnyxClient client = TelnyxOkHttpClient.fromEnv();
var balance = client.balance().retrieve();
System.out.println(balance);

Continue to the Java guide · Browse Java methods

Install

bundle add telnyx

First request

require "telnyx"

client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])
balance = client.balance.retrieve()
puts balance.inspect

Continue to the Ruby guide · Browse Ruby methods

Install

composer require telnyx/telnyx-php

First request

<?php

use Telnyx\Client;

$client = new Client(
    apiKey: getenv("TELNYX_API_KEY")
);
$balance = $client->balance->retrieve();
print_r($balance);

Continue to the PHP guide · Browse PHP methods

All SDK guides

TypeScript / Node.js — Guide · Methods · Package · Source · Releases
Python — Guide · Methods · Package · Source · Releases
Go — Guide · Methods · Package · Source · Releases
Java — Guide · Methods · Package · Source · Releases
Ruby — Guide · Methods · Package · Source · Releases
PHP — Guide · Methods · Package · Source · Releases

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.

SDK, CLI, or direct HTTP

Interface	Use for
SDK	Application integrations that require typed models, pagination, retries, and structured errors
Telnyx CLI	Shell workflows and automation
Direct HTTP	Endpoint tests, unsupported runtimes, or API capabilities not yet available in an SDK release

The API reference provides endpoint schemas and runnable HTTP and SDK examples.

Build with AI tools

Telnyx MCP server — connect AI assistants and agent frameworks to the Telnyx API for endpoint discovery and test requests. See Local MCP server and Remote MCP server.
Agent-readable documentation — llms.txt indexes the documentation set for LLM context loading. The API reference carries runnable samples for each official SDK.

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.

​Install an SDK and make a request

​All SDK guides

​Coverage and release cadence

​SDK, CLI, or direct HTTP

​Get help

Install an SDK and make a request

All SDK guides

Coverage and release cadence

SDK, CLI, or direct HTTP

Get help