API Reference | AgentPhone

Introduction

AgentPhone provides a REST API for provisioning phone numbers, managing AI agents, sending SMS, and placing voice calls. Most endpoints return JSON and require bearer authentication. Transcript streaming returns SSE. GET /v1/calls/{call_id}/recording returns binary recording audio and acts as a bearer link; see recording downloads. See Authentication.

Base URL

https://api.agentphone.ai

Append the complete path shown in each endpoint, such as /v1/numbers or /integrations/whatsapp/status. SDK base URLs use the origin above, without an extra /v1.

Available SDKs

TypeScript / JavaScript

Install with npm install agentphone — works in Node.js 18+, Deno, Bun, and Cloudflare Workers.

Python

Install with pip install agentphone — supports both sync and async clients, Python 3.9+.

Contribute

We welcome contributions to our SDKs. If you have suggestions or improvements, feel free to open a pull request on GitHub.

If there are other languages you’d like us to support, let us know!