Introduction
Run AI voice calling from your own systems — leads in, calls out, results back by webhook.
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
Agents
Create, configure, publish and test AI voice agents, or import them from another platform.
Calls
Place one call, then read its status, transcript, summary, outcome and recording.
Campaigns
Group leads with an agent and a caller ID, then dial them on a schedule.
Leads
Create, update and search the people your agents call. Keep a do-not-call list.
Send template and session messages from your connected WhatsApp Business number.
Tickets
Create and update support tickets, add notes and reply to customers.
Webhooks
Receive signed events, such as call.completed, instead of polling.
Migrate
Move from Vapi, Retell, Bland, ElevenLabs or Bolna.
The API covers the whole lifecycle:
- Agents — the AI voice agents that make and answer calls.
- Leads — the people to call, with their phone number and any fields your agent needs.
- Campaigns — a list of leads, an AI agent and a caller ID, dialled inside a calling window.
- Calls — every call placed, with its result: status, transcript, summary, outcome and recording.
- WhatsApp — follow-up messages through your connected WhatsApp Business number.
- Tickets — issues raised from calls for your team to resolve.
- 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).
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
- 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
| Base URL | https://api.callmitra.ai/api/v1 |
| Auth | X-API-Key: <your key> on every request (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) |
| Versioning | Additive changes only inside v1 (Versioning) |
Quickstart
Make your first request and start a campaign in a few minutes.
API reference
Every public endpoint, with request and response examples.
Docs for AI tools
Every page is also available as plain Markdown: add .md to the URL (for example /quickstart.md). /llms.txt lists all pages and /llms-full.txt contains the whole site in one file, ready to paste into an AI assistant.