Skip to content

Getting started

The Caller 9 API is a JSON REST API served from https://api.caller9.app. Everything you can see and change in the Caller 9 studio for your organization (studios, phone numbers, contacts, call history and live calls) is available to your own code.

API keys belong to an organization, and only organization admins can manage them.

  1. Open the Caller 9 studio and go to Settings → API Keys.
  2. Click Create API Key, give it a name that says what will use it, and pick an access level:
    • Read-only keys can only read data (GET requests).
    • Full access keys can also make changes, with the same rights as an organization admin.
  3. Copy the key. It starts with c9_ and is shown only once. Store it in a secret manager or environment variable, never in client-side code or a public repository.

Most endpoints are scoped to your organization. Its ID is a UUID shown under Settings → Organization, and also on the API Keys page.

List your studios:

Terminal window
export CALLER9_API_KEY="c9_..."
export CALLER9_ORG="your-organization-id"
curl https://api.caller9.app/v1/organizations/$CALLER9_ORG/studios \
-H "Authorization: Bearer $CALLER9_API_KEY"

Or from JavaScript (server-side, e.g. Node.js or a Cloudflare Worker):

const res = await fetch(
`https://api.caller9.app/v1/organizations/${process.env.CALLER9_ORG}/studios`,
{ headers: { Authorization: `Bearer ${process.env.CALLER9_API_KEY}` } },
)
if (!res.ok) throw new Error(`Caller 9 API error ${res.status}: ${(await res.json()).error}`)
const { studios } = await res.json()

Responses are JSON objects. Collections are wrapped in a named key (for example { "studios": [...] }), and single resources too (for example { "studio": {...} }).