Voice API documentation.
Use the REST API to provision numbers, place and receive calls, run WhatsApp Business calling and messaging on the numbers you already own, subscribe to webhooks, and track a prepaid wallet.
API documentation
Reference material for each Sautikit API surface.
Concepts
Core primitives: numbers, calls, webhooks, and billing explained.
Guides
Step-by-step recipes for common integration patterns.
API reference
Full REST API specification with request/response schemas.
Voice actions
Trigger TTS, play audio, gather DTMF input, and more.
Business calling on your own numbers, plus messaging, templates, and call permissions.
Webhooks
Event payloads, signatures, and delivery guarantees.
Errors
Error codes, HTTP status meanings, and retry guidance.
Changelog
Breaking changes, new endpoints, and SDK release notes.
Quickstart
Three steps to a live call. A workspace is free, a Kenyan number is KES 500 a month, and calls are KES 3.00 a minute, billed per second.
Get an API key
Create a key in the console under Settings → API keys and send it as Authorization: Bearer.
Buy a voice number
Claim a Kenyan number for KES 500 a month in the console or by API, then point it at your callback URL.
Place your first call
POST to /v1/calls and listen for webhook events as it rings, answers and ends.
Authentication
Every request needs a bearer token. Mint one in the console under API keys. Scope a restricted key to a single purpose.
// Keep the key in an environment variable: SAUTIKIT_API_KEY="eyJhbGciOiJF..."
// Every request sends it as a bearer token.
const res = await fetch("https://api.sautikit.com/v1/numbers/available", {
headers: { Authorization: `Bearer ${process.env.SAUTIKIT_API_KEY}` },
});
const numbers = await res.json();Per-endpoint auth requirements are listed on each operation page in the API reference.
Webhooks
Subscribe to call, number, and wallet events. Every webhook is HMAC-SHA256 signed; verify with the secret from your endpoint config.
X-Sautikit-Signature: t=1719500000,v1=<hex>HMAC-SHA256 over body + '.' + ts. See Verify webhook signatures.
Each event's payload has its own page. Start with call.started or wallet.low_balance. Create and manage subscriptions via the Webhooks group in the API reference.
SDKs
Install an SDK, set your API key, and place a call from Node.js or the browser.
Integration prompt
Generate an API integration prompt.
Choose a stack and goal, then copy the generated prompt into Claude, ChatGPT, or Cursor. It includes Sautikit API references and the selected integration requirements.