Highlights
Base URL and authentication
Base URL and authentication
401 Access denied.POST /v2/agent and POST /batches return 201, not 200
POST /v2/agent and POST /batches return 201, not 200
Both return
201 Created. The agent-create response field is state, not status. The legacy v1 /agent endpoint returns 200 — only v2 returns 201.scheduled_at must use +00:00, not Z
scheduled_at must use +00:00, not Z
A trailing
Z for UTC is rejected with a 500 error. Use a numeric offset instead, e.g. 2026-06-23T15:30:00+00:00. Scheduling must also be at least 2 minutes in the future, and Bolna rounds up to the next 10-minute mark.Wait for completed, not call-disconnected
Wait for completed, not call-disconnected
call-disconnected fires the instant the line drops — at that moment conversation_duration, total_cost, recording_url, and extracted_data are still null or 0. The completed event arrives a few seconds later with all fields populated.toolchain.pipelines is an array of arrays
toolchain.pipelines is an array of arrays
Not an array of strings. Correct shape:
"pipelines": [["transcriber", "llm", "synthesizer"]].GET /batches/{batch_id}/executions returns a bare array
GET /batches/{batch_id}/executions returns a bare array
Not wrapped in
{ "data": [...] } — the response is the array directly.Webhook source IP
Webhook source IP
Bolna sends webhooks from
13.203.39.153, 13.126.9.249 and 13.202.133.53. Whitelist all three or events will be dropped.What else is in the file
- The full execution status lifecycle (
queued → initiated → ringing → in-progress → call-disconnected → completed, plus terminal states) - The batch status lifecycle
- A minimal working agent creation body
- A key endpoint summary table