> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zudu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Get started with the Zudu AI API using API keys.

# 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`.

```bash theme={null}
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.