Skip to main content

Voka AI Developer API

A bearer-authed REST API plus HMAC-signed webhooks for the Voka voice platform. The same contract powers our official n8n, Zapier, and Make integrations — and yours.

Base URLhttps://voice.vokaai.com/api/v1
AuthBearer API key (Authorization: Bearer voka_live_…)
FormatJSON request + response, UTF-8
Rate limit60 requests / minute per customer + per API key
ErrorsRFC 9457 problem details with stable code extension
Webhook signingHMAC-SHA256 over ${timestamp}.${rawBody}
Quick start
  1. Mint an API key at voice.vokaai.com/integrations/api-keys
  2. Validate it with GET /api/v1/auth/whoami
  3. Subscribe to events with POST /api/v1/webhook-subscriptions
  4. Place an outbound call with POST /api/v1/outbound-calls

Full walkthrough on the Quickstart page.

What you can build today​

Read your call data. List, filter, paginate, and pull transcripts for every call your assistants handle.

Subscribe to live events. call.completed, call.insight.received, call.transcript.ready deliver to your endpoint within seconds of the call ending.

Initiate outbound calls. Trigger an AI assistant to dial a number with custom variables, and listen for status callbacks at the URL of your choice.

Manage assistants. Pull the list of assistants for dropdowns + dynamic field population in your wrapper.

Forward-compatibility contract​

Consumers MUST ignore unknown JSON fields

We add fields to responses and webhook payloads without warning — that's a non-breaking change. We do NOT remove or rename fields without a new event name or a /v2 API path.

If your wrapper hard-fails on unrecognized keys, that's a bug in the wrapper, not the API.

Status and changelog​

The API is stable. Breaking changes go through a /v2 path with a 6-month deprecation window on /v1.

See the Changelog for additions and the version timeline.

Need help?​