Telnyx CLI

The Telnyx CLI is the official command-line interface for managing Telnyx resources directly from your terminal. Send messages, manage phone numbers, control calls, and more — all without leaving the command line.

When to Use the CLI vs the API

Use Case	CLI	API
Quick manual tasks	✅ Best choice	Overkill
Scripting & automation	✅ Great for bash/shell	✅ Better for complex logic
CI/CD pipelines	✅ Simple integrations	✅ Full control
Production applications	❌ Not recommended	✅ Use SDKs or direct API
Exploring the API	✅ Fast iteration	Slower feedback loop

The CLI is ideal for operators, developers exploring the API, and simple automation. For production applications, use the Telnyx SDKs or call the REST API directly.

Features

Full API Coverage

Access all Telnyx APIs — messaging, voice, numbers, 10DLC, AI, verification, storage, and more

Multiple Output Formats

JSON, YAML, pretty-print, and raw output for scripting and human readability

Auto-generated from OpenAPI

Always in sync with the latest Telnyx API endpoints

Debug Mode

Inspect HTTP requests and responses for troubleshooting

Quick Example

# Set your API key
export TELNYX_API_KEY=KEY_xxxxxxxxxxxxx

# List your phone numbers
telnyx phone-numbers list

# Search for available phone numbers
telnyx available-phone-numbers list --filter.country-code US

# Send an SMS
telnyx messages send --from +15551234567 --to +15559876543 --text "Hello from CLI!"

# Check your balance
telnyx balance retrieve

Installation

Install via Go:

go install github.com/team-telnyx/telnyx-cli/cmd/telnyx@latest

Requires Go 1.22+. After installation, ensure $GOPATH/bin is in your PATH.

Installation Guide

Detailed installation instructions and troubleshooting

Documentation

Quickstart

Get up and running in 5 minutes

Authentication

Configure your API key

General Usage

Output formats, filtering, and scripting

Command Reference

Full list of all CLI commands

Resources

GitHub Repository

View source, report issues, and contribute

Releases & Changelog

Release notes and version history

API Reference

Full API documentation (CLI wraps these endpoints)

Go SDK

Install the Telnyx CLI

⌘I

Account setup

APIs fundamentals

Server-side SDKs

Development Tools

Migration Guides

Glossary

For AI Agents

Telnyx CLI

When to Use the CLI vs the API

Features

Full API Coverage

Multiple Output Formats

Auto-generated from OpenAPI

Debug Mode

Quick Example

Installation

Installation Guide

Documentation

Quickstart

Authentication

General Usage

Command Reference

Resources

GitHub Repository

Releases & Changelog

API Reference

​When to Use the CLI vs the API

​Features

Full API Coverage

Multiple Output Formats

Auto-generated from OpenAPI

Debug Mode

​Quick Example

​Installation

Installation Guide

​Documentation

Quickstart

Authentication

General Usage

Command Reference

​Resources

GitHub Repository

Releases & Changelog

API Reference

When to Use the CLI vs the API

Features

Quick Example

Installation

Documentation

Resources