VoiceMatrix Developer Platform

Everything on this page and the pages linked from it was checked against the code on origin/main (production) on 2026-08-24, re-checked mechanically on 2026-08-25 (every internal link, /ext route, event name, scope, error code and file reference), and then executed against a running deployment on the same day — a real key, every documented endpoint, a real webhook delivery whose signature was verified with the code on this site, and the MCP server driven end to end. See the changelog for what those passes corrected. Where a fact could not be verified against running code or a source file, it says so instead of guessing.

If you read the previous version of these docs: almost every concrete detail in it — the API host, the base path, the ID formats, the webhook event catalog, the error shape — was wrong. Not out of date; it described an API that was never built. This rewrite replaces it entirely. See CHANGELOG.md for exactly what changed and why.

What VoiceMatrix is

VoiceMatrix is a Hebrew-first voice AI platform: phone-native AI agents that take inbound calls, place outbound calls, qualify leads, book appointments, and hand off to a human or to another agent — with a real public API, webhooks, an MCP server, and native CRM integrations behind it.

Base URL

https://api.voicematrix.ai/api/v1/ext

Every route in this documentation is relative to that base. There is no /v1 at the root — v1 is inside the /ext path, not a version prefix on the host.

The 60-second quickstart

# 1. Mint a key — dashboard → Settings → API (self-serve since 2026-08-04)
#    You get the full key exactly once. It looks like: vm_live_<32 random characters>

# 2. Find out what your key can do (no scope required for this one)
curl https://api.voicematrix.ai/api/v1/ext/me \
  -H "X-API-Key: vm_live_your_key_here"

# 3. List your agents
curl https://api.voicematrix.ai/api/v1/ext/agents \
  -H "X-API-Key: vm_live_your_key_here"

# 4. Place an outbound call with one of them
curl -X POST https://api.voicematrix.ai/api/v1/ext/calls \
  -H "X-API-Key: vm_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"to": "+972501234567", "agent_id": "<agent-uuid-from-step-3>"}'

Authorization: Bearer vm_live_your_key_here works everywhere X-API-Key does — pick one convention and use it consistently.

What's actually here today

This section exists so you don't have to reverse-engineer what's real from what's aspirational. Every number is a route count from backend/internal/publicapi/routes.go, verified against the registered Gin routes, not a marketing figure.

Pages

1. Authentication — API keys, scopes, tiers, rate limits, versioning, GET /me
2. Resources
3. Calls
4. Leads
5. Agents — read, create, update, publish/unpublish
6. Knowledge Base — per-agent, RAG-backed
7. Phone Numbers — acquire and bind
8. Call Control — hangup (and what's deliberately not here)
9. Webhooks — real event catalog, signing, retries, replay, payload templating
10. Errors — the error envelope, every error code with its HTTP status, field-level validation errors, delivery error classes
11. MCP Server — connect Claude Code, Cursor, Claude Desktop
12. SDKs & OpenAPI — the honest current state, and how to generate a client today
13. Voice & Agent Capabilities — TTS/STT/LLM providers, multi-agent handoff, function tools
14. Integrations — Make.com, Salesforce, HubSpot, Google Workspace
15. Security & Data Residency — tenancy, encryption, what's honestly not encrypted yet
16. Changelog

Code examples

• cURL
• JavaScript / Node.js
• Python

Support

[email protected] · dashboard → Settings → API for key management.