developers
docs
Free to start·Pay as you go·No platform fees

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.

Base URLhttps://api.sautikit.com
Versionv1
CurrencyKES

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.

first-call.js
// place an outbound call
const res = await fetch("https://api.sautikit.com/v1/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SAUTIKIT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "+254200000001",
    to: ["+254720000000"],
    voice_callback_url: "https://your-app.example.com/webhook",
  }),
});
const call = await res.json();

Authentication

Every request needs a bearer token. Mint one in the console under API keys. Scope a restricted key to a single purpose.

auth.js
// 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.

call.startedcall.answeredcall.completedcall.failedcall.recording.availablenumber.provisionednumber.releasedwallet.top_upwallet.low_balancewhatsapp.event.receivedwhatsapp.call_permission.updatedwhatsapp.call.provisioned
signature-header.txt
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.

Node.js
npm i @sautikit/node
View SDK
Browser / WebRTC
npm i @sautikit/webrtc
View SDK

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.

Open the builder
ai-prompt.md
You are helping a developer build on Sautikit: programmable voice API, live in Kenya.

Reference (fetch this first, it is the canonical source):
  https://sautikit.com/llms-full.txt
  https://sautikit.com/openapi.public.yaml

Authentication: API keys via Authorization: Bearer header.
Base URL: https://api.sautikit.com
Currency: KES (prepaid wallet).

Their task: <describe your goal>

Constraints:
  - Use the language/framework they mention or ask before choosing.
  - All code samples must be self-contained and runnable end-to-end.
  - Treat the page above as authoritative; do not invent endpoint names.