Skip to navigation
Get started

Welcome

AgentPhone gives your application phone numbers for messaging and voice calls. Use the REST API or SDKs from your backend, or connect an AI assistant through MCP.

Choose your starting point

API quickstart

Create an agent, attach a number, and verify an inbound message.

Connect your AI

Connect an MCP client to use phone tools through your assistant.

API reference

Find request fields, response schemas, and endpoint details.

Choose a channel

GoalStart hereBefore sending
Send SMS or MMS from a US/Canadian numberPhone numbers and MessagesComplete SMS registration and check the number’s outboundSms status.
Send iMessageSet up iMessagePurchase an iMessage line; a standard SMS number does not become an iMessage line automatically.
Send WhatsApp messagesWhatsAppConnect your WhatsApp Business Account and use an approved template outside the customer service window.
Send branded RCSRCS Business MessagingRequest onboarding for an RCS sender.
Build a voice assistantAgents and CallsChoose hosted AI or your own voice webhook. Outbound phone calls also have a billing prerequisite.
Connect your own voice platformSIP trunkingRequest SIP access and configure voice routing.

How the resources fit together

  • Account / project: the scope for API keys, numbers, agents, and the default webhook. Use a sub-account to isolate a client or campaign.
  • Agent: configuration for a voice persona and a way to route a number’s events. One agent can have several numbers; a number can be attached to one agent.
  • Number: your sending address and inbound destination. Capabilities and billing depend on the number type.
  • Conversation: message history between one of your numbers and a contact or group. It can hold application metadata.
  • Call: a voice session with its own status, transcript, and optional recording.
  • Webhook: your HTTPS endpoint for inbound events. A per-agent webhook overrides the account default.

voiceMode: "hosted" supplies the AI for voice. It does not automatically answer text messages. Your application receives text events and sends replies through POST /v1/messages.

Quick start

Follow the API quickstart for prerequisites, commands, expected results, and a first-message check. For credentials and account selection, read Authentication.

Find help

Start with Troubleshooting for SMS activation, iMessage restrictions, webhook delivery, calls, and billing. When contacting support, include the response’s X-Request-Id, the relevant resource IDs, and a redacted request. You can also submit API feedback.