Skip to main content

​
Zudu API

Build, test, and operate production voice agents using the Zudu API.
This reference documents the HTTP endpoints your backend can call to create agents, manage phone numbers, and trigger real‑time calls.

​
Base URL

  • Production: https://api.zudu.ai
All endpoints shown in the API reference are relative to this base URL. (except batch-calls)

​
Authentication

  • Most endpoints require an organization header (for example orgId) and authentication headers.
  • The exact required headers and their names are shown on each endpoint page in the right‑hand panel.
Send those headers with every request you make to the API.

​
Quick example – create a phone call

The snippet below shows how to create an outbound phone call using POST /api/calls/create-phone-call. 
curl -X POST "https://api.zudu.ai/api/calls/create-phone-call"   -H "Content-Type: application/json"   -H "orgId: YOUR_ORGANIZATION_ID"   -d '{
    "from_number": "+14157774444",
    "to_number": "+12137774445",
    "override_agent_id": "agent-123",
    "metadata": {
      "customer_id": "cust-001",
      "campaign": "summer-2024",
      "priority": "high"
    }
  }'
Check the Create phone call endpoint page in the sidebar for the full list of fields, validation rules, and response shape.

​
Where to go next

  • Agents: Create and manage agents that power your calls.
  • Calls: Create outbound calls, fetch status, and list historical calls.
  • Phone numbers: Provision numbers and bind them to agents.
  • Batch calls: Trigger large outbound campaigns in a single request.
  • Knowledge bases & MCP servers: Connect external knowledge and tools to your agents.
For detailed request/response schemas and ready‑to‑copy examples, open any endpoint under API reference in the sidebar.