Skip to main content
The Kallabot API is the same API the Kallabot dashboard runs on. Anything you can do with an agent in the app, you can script: create and publish agents, place phone calls, start browser calls, read transcripts and recordings, manage numbers, and get a signed webhook the moment something happens.

5-minute quickstart

Create a key, create an agent, place a call and receive a webhook.

API reference

Every endpoint, generated from the live backend.

​
The basics

Base URL

https://api.kallabot.comEvery path starts with /v1.

Authentication

Authorization: Bearer kb_live_…Keys carry scopes.

Format

JSON in, JSON out. Errors are application/problem+json.

​
What you can build

Agents

Create agents from a JSON config, validate it, version it and publish it.

Phone calls

Place outbound calls, schedule them for later, read the transcript, recording and summary.

Browser calls

Let someone talk to an agent from a web page over WebRTC.

Webhooks

Signed events for calls, chats, tools, numbers, agents and knowledge.

Inbox

Read WhatsApp, Messenger, Instagram and web chat threads and manage their state.

Web chat

Create and publish website chat widgets.

​
Conventions you can rely on

Every endpoint follows the same rules, so you learn them once.

​
What the API doesn’t do yet

We keep this list honest so you don’t build on something that isn’t there.
  • API keys are made in the dashboard. A key can’t create other keys. See Authentication.
  • Replying to chats is dashboard-only for now. API keys can read inbox threads and change their state. See Inbox.
  • Connecting WhatsApp, Messenger and Instagram happens in the dashboard through Meta sign-in.
  • No campaigns API. To call a list, loop over it with POST /v1/calls or schedule calls.
Building with an AI coding tool? Every page has a menu to copy it as Markdown or open it in ChatGPT, Claude or Cursor. The API reference explains how to download the full OpenAPI spec.