Skip to content
Voice API

Communications your systems can drive directly.

Everything available in the Cloudial control plane is designed to be reachable programmatically, with the same policy validation and audit trail applied.

Example

Create a call flow as a reviewable draft

Set apply to false and the platform returns a configuration diff instead of mutating live routing. The same guardrails apply to API callers and humans alike.

POST /v1/call-flows
Authorization: Bearer <scoped-key>
Content-Type: application/json

{
  "name": "Sales line",
  "number": "+44...",
  "steps": [
    { "type": "business_hours", "schedule": "uk_office" },
    { "type": "ai_agent", "agent": "receptionist" },
    { "type": "queue", "skill": "new_business" },
    { "type": "voicemail", "transcribe": true }
  ],
  "apply": false
}
Capabilities

What the API covers

REST API

Provision users, numbers, routing and AI configuration programmatically.

Webhooks

Subscribe to call, message and configuration-change events in near real time.

Call control

Answer, transfer, record and branch calls from your own application logic.

Scoped credentials

API keys carry explicit scopes and tenant boundaries — no ambient access.

SIP interoperability

Open standards throughout, so carriers and equipment stay interchangeable.

Idempotent operations

Safe retries and deterministic results for automation pipelines.

Typed payloads

Predictable JSON schemas for every event and resource.

Environments

Separate sandbox and production credentials for safe development.

Build communications into your product.

Talk to us about API access during the Cloudial launch programme.