What is OneInbox?
OneInbox is a voice orchestration platform for building AI agents that handle live voice conversations — over the phone and in the browser. You configure agents, voices, and call behavior through the REST API. OneInbox handles real-time audio, speech recognition, telephony routing, and scaling.Keys
OneInbox has two kinds of keys. Which one you use depends on where your code runs — that distinction is the whole reason both exist.| Key | Starts with | Runs where | Can do |
|---|---|---|---|
| API key | oi_sk_ | Your server (backend) | Everything — create agents, make calls, read data |
| Publishable key | oi_pk_ | The browser (frontend) | Only start a call — nothing else |
Before you make your first API call, get your API key:
- Create a free account →
- Go to API Keys and click Create API key
- Copy the key — it starts with
oi_sk_ - Use it as
Authorization: Bearer <api_key>on every request
What you can build
| Use case | How |
|---|---|
| Outbound calling bot | Agent dials leads, qualifies them, books demos |
| Inbound support line | Assign a phone number — callers reach your agent 24/7 |
| Website voice widget | Add the Web SDK to your site with a publishable key — visitors talk to your agent right in the browser, no phone number needed |
How a call works
Caller speaks → transcribed to text → LLM decides reply → spoken back to caller. OneInbox runs this loop in real time. → How it worksGet started
Quickstart
Agent + phone number + your first real call
End-to-end walkthrough
Full outbound calling bot — agent, tools, phone number, call, results
API reference
Every endpoint with interactive Try It examples
Authentication
Get your API key and start making requests