Welcome
Build AI agents that can call, text, and stay compliant from day one.
Build AI agents that can call, text, and stay compliant, with one API. Saperly is the phone carrier for AI agents, giving your agent a real phone number, voice calling, SMS, consent tracking, and billing primitives.
Everything in these docs is organized around the shortest path to a live agent. Start with one line, one mode, and one real inbound test.
Create a line, receive a real call, and verify the happy path in minutes.
Every endpoint, request body, and response shape, generated from the OpenAPI spec.
The mental model behind lines, calls, conversations, and consent.
Pick the mode that matches how much control you need over the call loop.
Fastest setup. You provide the prompt, opening message, and voice. Saperly runs the call loop.
Your backend decides what the caller hears. Best when you already have agent logic or workflows.
Raw audio over WebSocket for realtime voice stacks and custom speech pipelines.
International destinations vary by zone — see Voice zones.
A real phone number that answers, handles FAQs, and hands off when it matters.
Outbound calls that confirm, reschedule, or cancel, with consent tracked end to end.
Two-way messaging with inbound replies, conversation history, and per-line routing.
Plug your own speech stack into a live phone call over WebSocket audio.
Create your Saperly account. You get a $5 signup credit (never expires), enough to run real test calls end to end.
Generate an API key from the portal and save the raw value somewhere safe. You will not see it again.
Read this if you want the mental model before the endpoint list. Lines are the primary resource. Calls and conversations hang off them. Consent and compliance events form an immutable audit trail.
How lines, calls, conversations, and consent fit together.
API key usage, environments, and the auth patterns that matter for integrations.
npm install @saperly/sdk. Typed client, zero runtime deps, Node 18+.
pip install saperly. Sync and async clients, Python 3.9+.
npx @saperly/mcp. Give Claude Code direct access to your Saperly account.
Ready to build. Head to the quickstart and get your first call live.