I · Developer platform
Get a phone number, answer calls, and handle customers, all via API or SDK. Type the code, hit launch, then call the agent below.
1
II · Quick start
Install, authenticate, create, provision, call.
Install
Add the OnCallClerk SDK via your package manager.
npm install @oncallclerk/sdk
Authenticate
Grab an API key from your dashboard and initialise the client.
import OnCallClerk from '@oncallclerk/sdk'
const client = new OnCallClerk({
apiKey: process.env.OCC_API_KEY,
})Create
Configure and deploy an agent with a single call.
const agent = await client.agents.create({
business_name: 'Acme Corp',
voice_id: 'f5HLTX707KIM4SzJYzSz',
greeting: 'Hello, thanks for calling Acme Corp!',
system_prompt: 'You are a helpful receptionist for Acme Corp...',
})Provision
Provision a number and attach it to the agent.
const number = await client.phoneNumbers.create({
agent_id: agent.id,
country: 'US',
})
console.log(number.phone_number) // '+14155550123'Live
Dial the assigned number, or test it from the dashboard. That's it. Your agent is live.
III · Authentication
All API requests require authentication via a bearer token in the Authorization header. Generate keys from your dashboard.
curl https://api.oncallclerk.com/agents \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Keep your key secret
Never expose your API key in client-side code or public repositories. Use environment variables.
IV · Explore the docs
REST
Complete REST documentation with endpoints, request and response schemas, and authentication. Covers agents, phone numbers, transcripts, and voices.
Read the API referenceTypeScript
Typed methods for every API operation. Install via npm, initialise with your key, and build with full IntelliSense support.
Read the SDK referenceExamples
Ready-to-use templates for common patterns: IVR flows, lead capture bots, appointment schedulers, and multi-agent setups.
Coming soonWebhooks
Receive notifications for call events, transcript completions, and agent status changes via webhooks you configure.
Coming soonV · Reference
Base URL
All API requests are made to:
Rate limits
VI · Pricing
All plans include a 14-day free trial. You only pay for calls we actually answer.
Calculate your savingsVII · Resources
How we think about latency, cost, and conversational quality. The same patterns we ship in the SDK, written up so you can audit, compare, or build your own.
The 2026 architecture for sub-second voice agents. Stack, latency budget, and where DIY pipelines break.
A diagnostic playbook for engineers shipping a voice agent that already exists and feels too slow.
Real per-minute cost decomposition. Why the spreadsheet number is roughly a third of the actual bill.
Prosody, filler words, barge-in handling, and the conversational craft that separates good agents from obvious bots.
Minimum viable spend for a production voice agent. Component-by-component cost trade-offs.
Time-to-market guide. SDK vs managed vs DIY across days, weeks, and months.
Create your free account, grab an API key, and deploy your first voice agent in under five minutes.