> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.agentphone.ai/welcome/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentphone.ai/_mcp/server.

# Welcome

> Give your AI agents phone numbers, SMS, and voice calls.

> **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](#quick-start)

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

#### [API Reference](/api-reference)

Explore the full API with interactive examples and SDK snippets.

#### [MCP Server](/mcp)

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

## Core Concepts

#### [Agents](/documentation/guides/agents)

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

#### [Phone Numbers](/documentation/guides/phone-numbers)

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

#### [Messages](/documentation/guides/messages)

Send and receive SMS, MMS, and iMessage — threads, media, reactions, effects, and group chats.

#### [WhatsApp](/documentation/guides/whatsapp)

Connect your WhatsApp Business Account. Templates, buttons, list menus, and quote replies.

#### [Calls](/documentation/guides/calls)

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

#### [Webhooks](/documentation/guides/webhooks)

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

#### [Usage & Billing](/usage)

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

## Quick Start

### Create an agent

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

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

### Provision a phone number

Get an SMS- and voice-enabled phone number.

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

### Attach the number to your agent

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

```bash
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"}'
```

### Configure a webhook

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

```bash
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"}'
```

### 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

```mermaid
graph TD
    P[Project] --> A[Agents]
    P --> W[Webhooks]

    A -- "attach" --> N[Phone Numbers]
    A --> C[Conversations]
    A --> CL[Calls]

    C --> M[Messages]
    CL --> T[Transcripts]
    W --> D[Deliveries]

    style P fill:#00e676,color:#000,stroke:none
    style A fill:#0f0f16,color:#fff,stroke:#00e676,stroke-width:2px
    style N fill:#0f0f16,color:#fff,stroke:#00e676,stroke-width:2px
    style C fill:#0f0f16,color:#fff,stroke:#00e676,stroke-width:2px
    style CL fill:#0f0f16,color:#fff,stroke:#00e676,stroke-width:2px
    style W fill:#0f0f16,color:#fff,stroke:#00e676,stroke-width:2px
    style M fill:#0f0f16,color:#fff,stroke:#555
    style T fill:#0f0f16,color:#fff,stroke:#555
    style D fill:#0f0f16,color:#fff,stroke:#555
```

## Need Help?

#### [GitHub](https://github.com/AgentPhone-AI)

Check out our open-source SDKs and MCP server.

#### [Home](https://agentphone.ai)

Visit the AgentPhone website to get your API key.

> Give your AI agents phone numbers, SMS, and voice calls.