# Introduction (/)

The CallMitra API lets your CRM, website or backend drive the same AI voice agents your team uses in the console. You send people to call, CallMitra's agents call them over Indian phone lines, and you get the transcript, summary and outcome of every call back as JSON.

## What you can build [#what-you-can-build]

<Cards>
<Card title="Agents" href="/guides/agents">
Create, configure, publish and test AI voice agents, or import them from another platform.
</Card>

<Card title="Calls" href="/guides/direct-calls">
Place one call, then read its status, transcript, summary, outcome and recording.
</Card>

<Card title="Campaigns" href="/guides/campaigns">
Group leads with an agent and a caller ID, then dial them on a schedule.
</Card>

<Card title="Leads" href="/guides/leads">
Create, update and search the people your agents call. Keep a do-not-call list.
</Card>

<Card title="WhatsApp" href="/guides/whatsapp">
Send template and session messages from your connected WhatsApp Business number.
</Card>

<Card title="Tickets" href="/guides/tickets">
Create and update support tickets, add notes and reply to customers.
</Card>

<Card title="Webhooks" href="/webhooks">
Receive signed events, such as `call.completed`, instead of polling.
</Card>

<Card title="Migrate" href="/migrate">
Move from Vapi, Retell, Bland, ElevenLabs or Bolna.
</Card>
</Cards>

The API covers the whole lifecycle:

1. **Agents** — the AI voice agents that make and answer calls.
2. **Leads** — the people to call, with their phone number and any fields your agent needs.
3. **Campaigns** — a list of leads, an AI agent and a caller ID, dialled inside a calling window.
4. **Calls** — every call placed, with its result: status, transcript, summary, outcome and recording.
5. **WhatsApp** — follow-up messages through your connected WhatsApp Business number.
6. **Tickets** — issues raised from calls for your team to resolve.
7. **Webhooks** — call results and other events pushed to your server as they happen.

Each API key can be limited to the resources it needs ([scopes](/authentication#limit-what-a-key-can-do)).

## How calls reach your customers [#how-calls-reach-your-customers]

Calls go out over phone carriers connected to your workspace: **Twilio**, **Plivo** and **Vobiz** numbers, or your own **SIP trunk**. You connect numbers in the console under **Phone numbers**; the API lists them so you can pick a caller ID. Agents speak Indian English, Hindi and other Indian languages, depending on how the agent is configured.

## Before you start [#before-you-start]

- A CallMitra workspace, and a **manager** role in it (only managers can create API keys).
- At least one connected phone number (set up in the console). You can create agents in the console or through the API.
- A server to keep your API key on. Never put a key in a browser or a mobile app.

## Conventions at a glance [#conventions-at-a-glance]

| | |
| --- | --- |
| Base URL | `https://api.callmitra.ai/api/v1` |
| Auth | `X-API-Key: <your key>` on every request ([Authentication](/authentication)) |
| Format | JSON request and response bodies, camelCase field names |
| IDs | UUID strings |
| Time | ISO 8601 timestamps in UTC |
| Phone numbers | E.164, for example `+919876543210` |
| Errors | One envelope with a stable `error.code` ([Errors](/errors)) |
| Versioning | Additive changes only inside v1 ([Versioning](/versioning)) |

<Cards>
<Card title="Quickstart" href="/quickstart">
Make your first request and start a campaign in a few minutes.
</Card>

<Card title="API reference" href="/api-reference">
Every public endpoint, with request and response examples.
</Card>
</Cards>

## Docs for AI tools [#docs-for-ai-tools]

Every page is also available as plain Markdown: add `.md` to the URL (for example [/quickstart.md](/quickstart.md)). [/llms.txt](/llms.txt) lists all pages and [/llms-full.txt](/llms-full.txt) contains the whole site in one file, ready to paste into an AI assistant.