Get Started

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.

Get started

Quickstart

Create a line, receive a real call, and verify the happy path in minutes.

API reference

Every endpoint, request body, and response shape, generated from the OpenAPI spec.

Core concepts

The mental model behind lines, calls, conversations, and consent.

Choose your path

Pick the mode that matches how much control you need over the call loop.

Hosted mode

Fastest setup. You provide the prompt, opening message, and voice. Saperly runs the call loop.

Webhook mode

Your backend decides what the caller hears. Best when you already have agent logic or workflows.

Audio mode

Raw audio over WebSocket for realtime voice stacks and custom speech pipelines.

Mode comparison

HostedWebhookAudio
Setup time~5 min~15 min~30 min
ControlLowMediumFull
Cost (Zone A)$0.26/min$0.13/min$0.13/min
Best forFAQ bots, receptionistsCustom agent logicVoice-native AI stacks
You needJust an API keyA webhook serverA WebSocket server

International destinations vary by zone — see Voice zones.

All new accounts get a $5 signup credit that never expires. That covers ~19 minutes of hosted calls, ~38 minutes of webhook calls, ~250 SMS, or 2 months of one phone number.

What you can build

Receptionist AI

A real phone number that answers, handles FAQs, and hands off when it matters.

Appointment reminder

Outbound calls that confirm, reschedule, or cancel, with consent tracked end to end.

Customer support SMS

Two-way messaging with inbound replies, conversation history, and per-line routing.

Voice-native AI agent

Plug your own speech stack into a live phone call over WebSocket audio.

Easiest onboarding flow

1

Sign up

Create your Saperly account. You get a $5 signup credit (never expires), enough to run real test calls end to end.

2

Get your API key

Generate an API key from the portal and save the raw value somewhere safe. You will not see it again.

3

Create a line

Provision one line in hosted mode or webhook mode. Keep the first use case narrow.

4

Call your number

Dial the number from your phone. Confirm the connection, audio, and transcript all flow through.

5

Inspect the call record

Open the call in the portal or fetch it from the API. Verify duration, transcript, and billing line up.

Core concepts

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.

Core concepts

How lines, calls, conversations, and consent fit together.

Authentication

API key usage, environments, and the auth patterns that matter for integrations.

SDKs and tools

TypeScript SDK

npm install @saperly/sdk. Typed client, zero runtime deps, Node 18+.

Python SDK

pip install saperly. Sync and async clients, Python 3.9+.

MCP server

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.