# AgentPhone

## Docs

- [Welcome](https://docs.agentphone.to/welcome.mdx): Give your AI agents phone numbers, SMS, and voice calls.
- [Agents](https://docs.agentphone.to/documentation/guides/agents.mdx): Create and manage AI agent personas with phone numbers, voice modes, and system prompts
- [Phone numbers](https://docs.agentphone.to/documentation/guides/phone-numbers.mdx): Provision, manage, and release SMS- and voice-enabled phone numbers
- [Conversations](https://docs.agentphone.to/documentation/guides/conversations.mdx): Manage message threads, media, and reactions across SMS and iMessage
- [Calls](https://docs.agentphone.to/documentation/guides/calls.mdx): Voice call flows, streaming responses, live transcript streaming, recordings, and call management
- [Webhooks](https://docs.agentphone.to/documentation/guides/webhooks.mdx): Configure webhook endpoints and receive real-time event notifications
- [Agent Webhooks](https://docs.agentphone.to/documentation/guides/agent-webhooks.mdx): Configure per-agent webhook endpoints for routing events to different destinations
- [Usage & Billing](https://docs.agentphone.to/usage.mdx): Pay-as-you-go pricing, balance management, and usage monitoring
- [Pagination](https://docs.agentphone.to/documentation/reference/pagination.mdx): How to paginate through list endpoints in the AgentPhone API.
- [Error Handling](https://docs.agentphone.to/documentation/reference/error-handling.mdx): HTTP status codes, error response format, and error handling best practices
- [Messaging Rate Limits](https://docs.agentphone.to/documentation/reference/messaging-rate-limits.mdx): Daily message limits and throughput rates for SMS (10DLC) and iMessage
- [Testing](https://docs.agentphone.to/documentation/reference/testing.mdx): Test webhooks locally, use mock payloads, and verify your integration
- [Best Practices](https://docs.agentphone.to/documentation/reference/best-practices.mdx): Voice latency, security, webhook reliability, and performance tips
- [Code Examples](https://docs.agentphone.to/documentation/reference/code-examples.mdx): End-to-end examples for common AgentPhone integrations.
- [FAQ](https://docs.agentphone.to/documentation/reference/faq.mdx): Frequently asked questions about AgentPhone
- [TypeScript SDK](https://docs.agentphone.to/documentation/sdks/typescript.mdx): Official TypeScript/JavaScript SDK for the AgentPhone API
- [Python SDK](https://docs.agentphone.to/documentation/sdks/python.mdx): Official Python SDK for the AgentPhone API
- [Coding Agents](https://docs.agentphone.to/integrations/connect-your-ai/coding-agents.mdx): Give Claude Code, Cursor, Windsurf, and Claude Desktop the ability to make phone calls and send SMS
- [OpenClaw](https://docs.agentphone.to/integrations/connect-your-ai/open-claw.mdx): Give your OpenClaw agent a phone number — calls and SMS in under 2 minutes
- [Hermes Agent](https://docs.agentphone.to/integrations/connect-your-ai/hermes-agent.mdx): Add phone calls and SMS to your Hermes Agent with one config block
- [GBrain](https://docs.agentphone.to/integrations/connect-your-ai/g-brain.mdx): Replace GBrain's 10-step Twilio voice recipe with 3 API calls
- [Recipe: Personal AI Phone Agent](https://docs.agentphone.to/personal-ai-phone-agent.mdx): Build a personal AI phone agent that calls you and holds conversations — in under 2 minutes, no Twilio or server setup required.
- [AgentDiscuss](https://docs.agentphone.to/integrations/connect-your-ai/agent-discuss.mdx): Use AgentPhone through the AgentDiscuss Agentic API marketplace
- [MCP Server](https://docs.agentphone.to/mcp.mdx): Give AI agents phone numbers, SMS, and voice calls via the Model Context Protocol
- [Claude Code Skill](https://docs.agentphone.to/integrations/tools/claude-code-skill.mdx): Use AgentPhone directly from Claude Code with the official skill
- [LangChain](https://docs.agentphone.to/integrations/tools/lang-chain.mdx): Give your LangChain agent phone numbers, voice calls, and messaging with AgentPhone
- [Google ADK](https://docs.agentphone.to/integrations/tools/google-adk.mdx): Give your Google ADK agent phone numbers, voice calls, and SMS with AgentPhone
- [Smithery](https://docs.agentphone.to/integrations/tools/smithery.mdx): Install the AgentPhone MCP server from Smithery with one command
- [API Reference](https://docs.agentphone.to/api-reference.mdx): Explore the AgentPhone API with interactive examples and SDK snippets.

## API Docs

- API Reference > agent-signup [Agent Sign Up](https://docs.agentphone.to/api-reference/agent-signup/agent-sign-up-v-0-agent-sign-up-post.mdx)
- API Reference > agent-signup [Agent Verify](https://docs.agentphone.to/api-reference/agent-signup/agent-verify-v-0-agent-verify-post.mdx)
- API Reference > agents [List Voices](https://docs.agentphone.to/api-reference/agents/list-voices-v-1-agents-voices-get.mdx)
- API Reference > agents [List Agents](https://docs.agentphone.to/api-reference/agents/list-agents-v-1-agents-get.mdx)
- API Reference > agents [Create Agent](https://docs.agentphone.to/api-reference/agents/create-agent-v-1-agents-post.mdx)
- API Reference > agents [Get Agent](https://docs.agentphone.to/api-reference/agents/get-agent-v-1-agents-agent-id-get.mdx)
- API Reference > agents [Delete Agent](https://docs.agentphone.to/api-reference/agents/delete-agent-v-1-agents-agent-id-delete.mdx)
- API Reference > agents [Update Agent](https://docs.agentphone.to/api-reference/agents/update-agent-v-1-agents-agent-id-patch.mdx)
- API Reference > agents [Attach Number To Agent](https://docs.agentphone.to/api-reference/agents/attach-number-to-agent-v-1-agents-agent-id-numbers-post.mdx)
- API Reference > agents [Detach Number From Agent](https://docs.agentphone.to/api-reference/agents/detach-number-from-agent-v-1-agents-agent-id-numbers-number-id-delete.mdx)
- API Reference > agents [List Agent Conversations](https://docs.agentphone.to/api-reference/agents/list-agent-conversations-v-1-agents-agent-id-conversations-get.mdx)
- API Reference > agents [List Agent Calls](https://docs.agentphone.to/api-reference/agents/list-agent-calls-v-1-agents-agent-id-calls-get.mdx)
- API Reference > numbers [List Numbers](https://docs.agentphone.to/api-reference/numbers/list-numbers-v-1-numbers-get.mdx)
- API Reference > numbers [Create Number](https://docs.agentphone.to/api-reference/numbers/create-number-v-1-numbers-post.mdx)
- API Reference > numbers [Get Messages](https://docs.agentphone.to/api-reference/numbers/get-messages-v-1-numbers-number-id-messages-get.mdx)
- API Reference > numbers [Delete Number](https://docs.agentphone.to/api-reference/numbers/delete-number-v-1-numbers-number-id-delete.mdx)
- API Reference > webhooks [Get Webhook](https://docs.agentphone.to/api-reference/webhooks/get-webhook-v-1-webhooks-get.mdx)
- API Reference > webhooks [Create Or Update Webhook](https://docs.agentphone.to/api-reference/webhooks/create-or-update-webhook-v-1-webhooks-post.mdx)
- API Reference > webhooks [Delete Webhook](https://docs.agentphone.to/api-reference/webhooks/delete-webhook-v-1-webhooks-delete.mdx)
- API Reference > webhooks [List Deliveries](https://docs.agentphone.to/api-reference/webhooks/list-deliveries-v-1-webhooks-deliveries-get.mdx)
- API Reference > webhooks [Delivery Stats](https://docs.agentphone.to/api-reference/webhooks/delivery-stats-v-1-webhooks-deliveries-stats-get.mdx)
- API Reference > webhooks [All Time Stats](https://docs.agentphone.to/api-reference/webhooks/all-time-stats-v-1-webhooks-deliveries-all-time-get.mdx)
- API Reference > webhooks [Test Webhook](https://docs.agentphone.to/api-reference/webhooks/test-webhook-v-1-webhooks-test-post.mdx)
- API Reference > agent-webhooks [Get Agent Webhook](https://docs.agentphone.to/api-reference/agent-webhooks/get-agent-webhook-v-1-agents-agent-id-webhook-get.mdx)
- API Reference > agent-webhooks [Create Or Update Agent Webhook](https://docs.agentphone.to/api-reference/agent-webhooks/create-or-update-agent-webhook-v-1-agents-agent-id-webhook-post.mdx)
- API Reference > agent-webhooks [Delete Agent Webhook](https://docs.agentphone.to/api-reference/agent-webhooks/delete-agent-webhook-v-1-agents-agent-id-webhook-delete.mdx)
- API Reference > agent-webhooks [List Agent Deliveries](https://docs.agentphone.to/api-reference/agent-webhooks/list-agent-deliveries-v-1-agents-agent-id-webhook-deliveries-get.mdx)
- API Reference > agent-webhooks [Test Agent Webhook](https://docs.agentphone.to/api-reference/agent-webhooks/test-agent-webhook-v-1-agents-agent-id-webhook-test-post.mdx)
- API Reference > contacts [List Contacts](https://docs.agentphone.to/api-reference/contacts/list-contacts-v-1-contacts-get.mdx)
- API Reference > contacts [Create Contact](https://docs.agentphone.to/api-reference/contacts/create-contact-v-1-contacts-post.mdx)
- API Reference > contacts [Get Contact](https://docs.agentphone.to/api-reference/contacts/get-contact-v-1-contacts-contact-id-get.mdx)
- API Reference > contacts [Delete Contact](https://docs.agentphone.to/api-reference/contacts/delete-contact-v-1-contacts-contact-id-delete.mdx)
- API Reference > contacts [Update Contact](https://docs.agentphone.to/api-reference/contacts/update-contact-v-1-contacts-contact-id-patch.mdx)
- API Reference > conversations [List Conversations](https://docs.agentphone.to/api-reference/conversations/list-conversations-v-1-conversations-get.mdx)
- API Reference > conversations [Get Conversation](https://docs.agentphone.to/api-reference/conversations/get-conversation-v-1-conversations-conversation-id-get.mdx)
- API Reference > conversations [Update Conversation](https://docs.agentphone.to/api-reference/conversations/update-conversation-v-1-conversations-conversation-id-patch.mdx)
- API Reference > conversations [Get Conversation Messages](https://docs.agentphone.to/api-reference/conversations/get-conversation-messages-v-1-conversations-conversation-id-messages-get.mdx)
- API Reference > calls [List Calls](https://docs.agentphone.to/api-reference/calls/list-calls-v-1-calls-get.mdx)
- API Reference > calls [Create Outbound Call](https://docs.agentphone.to/api-reference/calls/create-outbound-call-v-1-calls-post.mdx)
- API Reference > calls [Create Web Call](https://docs.agentphone.to/api-reference/calls/create-web-call-v-1-calls-web-post.mdx)
- API Reference > calls [Get Call](https://docs.agentphone.to/api-reference/calls/get-call-v-1-calls-call-id-get.mdx)
- API Reference > calls [Get Call Transcript](https://docs.agentphone.to/api-reference/calls/get-call-transcript-v-1-calls-call-id-transcript-get.mdx)
- API Reference > calls [Stream Call Transcript](https://docs.agentphone.to/api-reference/calls/stream-call-transcript-v-1-calls-call-id-transcript-stream-get.mdx)
- API Reference > calls [List Calls For Number](https://docs.agentphone.to/api-reference/calls/list-calls-for-number-v-1-numbers-number-id-calls-get.mdx)
- API Reference > usage [Get Usage](https://docs.agentphone.to/api-reference/usage/get-usage-v-1-usage-get.mdx)
- API Reference > usage [Get Daily Usage](https://docs.agentphone.to/api-reference/usage/get-daily-usage-v-1-usage-daily-get.mdx)
- API Reference > usage [Get Monthly Usage](https://docs.agentphone.to/api-reference/usage/get-monthly-usage-v-1-usage-monthly-get.mdx)
- API Reference > messages [Send Message](https://docs.agentphone.to/api-reference/messages/send-message-v-1-messages-post.mdx)
- API Reference > messages [Send Reaction](https://docs.agentphone.to/api-reference/messages/send-reaction-v-1-messages-message-id-reactions-post.mdx)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.agentphone.to/openapi.json)
- [OpenAPI YAML](https://docs.agentphone.to/openapi.yaml)