Base URL
POST /v1/calls means POST https://api.callingbox.io/v1/calls.
Authentication
Every request needs a Bearer token:sk_ and belong to your organization. Create them from API Keys in the dashboard.
The dashboard uses session cookies, not API keys. The Bearer token described here is for the public
/v1 API only.Request format
- Request bodies are JSON (
Content-Type: application/json) - Phone numbers use E.164 format (e.g.
+15551234567) - Responses are JSON with standard HTTP status codes
Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/numbers | List the phone numbers in your org |
GET | /v1/numbers/available | Search for numbers available for purchase |
POST | /v1/numbers/purchase | Purchase a phone number |
GET | /v1/agents | List inbound and outbound agents |
POST | /v1/agents | Create an agent |
GET | /v1/agents/{id} | Get one agent by ID |
PATCH | /v1/agents/{id} | Update an agent |
DELETE | /v1/agents/{id} | Archive an agent |
POST | /v1/agents/{id}/numbers | Attach a number to an agent |
DELETE | /v1/agents/{id}/numbers/{number_id} | Detach a number |
PUT | /v1/agents/{id}/primary-number | Set the agent’s primary number |
POST | /v1/calls | Dispatch an outbound call from an agent |
GET | /v1/calls | List all calls (inbound and outbound) |
GET | /v1/calls/{id} | Get one call by ID |
The SDKs and CLI are wrappers around these same
/v1 endpoints. See SDKs & tools for the Python SDK, TypeScript SDK, and CLI docs.Error responses
Errors come back as JSON with anerror field:
| Status | What it means |
|---|---|
201 | Call created |
400 | Bad request (missing fields, wrong format) |
401 | Bad or missing API key |
404 | Call not found |
502 | Telephony provider error |