For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
HomeGet API key
DocumentationIntegrationsAPI Reference
DocumentationIntegrationsAPI Reference
  • Get Started
    • Welcome
  • Guides
    • Agents
    • Phone Numbers
    • Conversations
    • Calls
    • Webhooks
    • Agent Webhooks
    • Usage & Billing
  • Reference
    • Pagination
    • Error Handling
    • Messaging Rate Limits
    • Testing
    • Best Practices
    • Code Examples
    • FAQ
  • SDKs
    • TypeScript / JavaScript
    • Python
LogoLogo
HomeGet API key
On this page
  • Get Started
  • Core Concepts
  • Quick Start
  • Authentication
  • Base URL
  • Resource Relationships
  • Need Help?
Get Started

Welcome

Was this page helpful?

Agents

Next
Built with
Welcome to AgentPhone!

Give your AI agents their own phone numbers to send SMS, receive calls, and have voice conversations — all through a simple API.

AgentPhone is an API platform that provisions phone numbers for AI agents. Attach numbers to agent personas, manage SMS conversations, place and receive voice calls, and get real-time webhook notifications — all with a few API calls.

Get Started

Quickstart

Create your first agent and attach a phone number in minutes.

API Reference

Explore the full API with interactive examples and SDK snippets.

MCP Server

Give Cursor, Claude Desktop, or any MCP client access to phone tools.

Core Concepts

Agents

AI personas that own phone numbers. Operate in webhook mode (your backend) or hosted mode (built-in LLM).

Phone Numbers

SMS- and voice-enabled numbers provisioned through Twilio. Attach to agents for inbound routing.

Conversations

SMS threads between your agent’s number and external participants, with message history and metadata.

Calls

Inbound, outbound, and browser-based web calls with real-time transcripts, live transcript streaming via SSE, and duration tracking.

Webhooks

Real-time events (agent.message, agent.call_ended) delivered to your server with HMAC signatures.

Usage & Billing

Pay-as-you-go pricing, balance management, and usage monitoring.

Quick Start

1

Create an agent

Define your AI persona with a name and optional voice configuration.

$curl -X POST "https://api.agentphone.ai/v1/agents" \
>  -H "Authorization: Bearer YOUR_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{"name": "Support Bot"}'
2

Provision a phone number

Get an SMS- and voice-enabled phone number.

$curl -X POST "https://api.agentphone.ai/v1/numbers" \
>  -H "Authorization: Bearer YOUR_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{}'
3

Attach the number to your agent

Link the number so it can send and receive on behalf of the agent.

$curl -X POST "https://api.agentphone.ai/v1/agents/{agent_id}/numbers" \
>  -H "Authorization: Bearer YOUR_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{"numberId": "NUMBER_ID"}'
4

Configure a webhook

Set up a URL to receive agent.message (SMS/voice turns) and agent.call_ended (post-call summary + full transcript) events.

$curl -X POST "https://api.agentphone.ai/v1/webhooks" \
>  -H "Authorization: Bearer YOUR_API_KEY" \
>  -H "Content-Type: application/json" \
>  -d '{"url": "https://your-server.com/webhook"}'
5

Start receiving messages and calls

Your agent is live! Inbound SMS and calls will be forwarded to your webhook.

Authentication

Include your API key as a Bearer token in every request:

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.agentphone.ai/v1

Resource Relationships

Need Help?

GitHub

Check out our open-source SDKs and MCP server.

Home

Visit the AgentPhone website to get your API key.