# EnableCalls API: AI phone calls from your own systems

Send a lead from your CRM and an AI employee calls them within seconds in Telugu, Hindi or English. Push a list into a campaign. Get each conversation's outcome, summary, captured details and transcript the moment it ends.

## What can you build with the EnableCalls API?

Anything that should end in a phone call or start from one. The API drives the same AI employees you build in the dashboard, with the same calling rules and the same per-minute coins. Using the API costs nothing extra.

| You want to… | Use |
| --- | --- |
| Call one person now or at a set time (a form fill, a missed cart, a new CRM lead) | `POST /calls` (with `scheduled_at` for later) |
| Call a list within calling hours, with retries | `POST /campaigns` with `launch: true` |
| Know what happened on a call | Webhooks (pushed to you), or `GET /leads/{id}` |
| Keep your CRM's details on each person | `POST /contacts` with `fields` |
| Stop calling someone | `POST /dnc` |
| See which employees and numbers you have | `GET /employees`, `GET /phone-numbers` |

## How do I place my first call?

1. In the dashboard, open **Developers** and create a key with full access. Copy it: it is shown once.
2. Find your employee's id with `GET /employees`. The employee needs its own phone number.
3. Send the request below to your own phone first. Add `"dry_run": true` to run every check without calling anyone.
4. Subscribe a webhook to `call.completed` and `call.not_connected`, or read `GET /calls/{id}` until the status is final.

Place a call:

```bash
curl https://api.enablecalls.com/v1/calls \
  -H "Authorization: Bearer $ENABLECALLS_API_KEY" \
  -H "Idempotency-Key: lead-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "EMPLOYEE_ID",
    "phone": "+91XXXXXXXXXX",
    "name": "Ravi Kumar",
    "details": { "Course": "MBA", "City": "Pune" },
    "external_id": "lead-1042",
    "max_attempts": 2,
    "retry_after_minutes": 30
  }'
```

The answer is the call, which starts as `queued` (or `scheduled` outside calling hours):

201 Created:

```json
{
  "object": "call",
  "id": "8f0c1d6e-2b9a-4a51-9c1e-3c4f5a6b7c8d",
  "employee_id": "EMPLOYEE_ID",
  "phone": "+91XXXXXXXXXX",
  "name": "Ravi Kumar",
  "details": { "Course": "MBA", "City": "Pune" },
  "external_id": "lead-1042",
  "metadata": null,
  "source": "api",
  "status": "queued",
  "status_detail": "Dialling within seconds.",
  "attempts_made": 0,
  "max_attempts": 2,
  "next_attempt_at": null,
  "result": null,
  "created_at": "2026-10-31T05:30:00Z"
}
```

## What are the basics?

- Base URL: `https://api.enablecalls.com/v1`. JSON in and out; times are UTC ISO-8601; phone numbers come back as `+91XXXXXXXXXX`.
- Every request carries `Authorization: Bearer ec_live_…`. See [Authentication](https://enablecalls.com/developers/authentication).
- Every write accepts `"dry_run": true` and an `Idempotency-Key` header. See [Errors and limits](https://enablecalls.com/developers/errors).
- Calls follow your employee's number, calling hours (9 AM to 9 PM India time), your do-not-call list and your coins. See [Calls and retries](https://enablecalls.com/developers/calls).
- The machine-readable spec is at [https://api.enablecalls.com/v1/openapi.json](https://api.enablecalls.com/v1/openapi.json), and every endpoint is in the [API reference](https://enablecalls.com/developers/reference).

## How do the objects fit together?

| Object | What it is |
| --- | --- |
| employee | An AI employee you built: its voice, languages, instructions and phone number. |
| call | One request to call one person. It may take up to 3 attempts; its `result` is the conversation. |
| lead | The result of a conversation from any source: single calls, campaigns and incoming calls. |
| campaign | A list of people called by one employee within a calling window, with retries. |
| contact | A person and your own details about them (contact fields), used as `{{placeholders}}`. |
| event | Something that happened, sent to your webhook endpoints and kept for 30 days. |

## Frequently asked questions

### Does the EnableCalls API cost extra?

No. Calls placed through the API use coins at your usual per-minute rate, billed on connected time in 30-second blocks. Unanswered and busy calls cost nothing.

### Which languages can API calls use?

The employee's own languages: Telugu, Hindi, English and other Indian languages, chosen when you build the employee. The API does not change the voice or language per call.

### Can I use the API from n8n, Make or Zapier?

Yes. Use an HTTP request step with your key in the Authorization header, and receive results with a webhook trigger. See the no-code guide.

### Can the API call people at night?

No. Calls outside 9 AM to 9 PM India time wait for the next morning, and promotional campaigns call only between 10 AM and 7 PM, as TRAI requires.

## More EnableCalls API docs

- [Authentication](https://enablecalls.com/developers/authentication.md): Create EnableCalls API keys on the Developers page, choose full or read-only access, and send them as a Bearer token. Keys are shown once and can be revoked at once.
- [Calls and retries](https://enablecalls.com/developers/calls.md): How EnableCalls API calls move from queued to completed: calling hours, do-not-call, coins, the 30-minute cooldown, automatic retries for unanswered calls and every status.
- [Webhooks and events](https://enablecalls.com/developers/webhooks.md): Receive call.completed, call.not_connected, lead and appointment events on your URL, verify the HMAC-SHA256 signature, and understand retries and the event log.
- [Errors and limits](https://enablecalls.com/developers/errors.md): The EnableCalls API error format, rate limits per key, Idempotency-Key for safe retries, dry runs and starting_after pagination.
- [n8n, Make, Zapier](https://enablecalls.com/developers/no-code.md): Call new leads from n8n, Make, Zapier or Pabbly Connect with an HTTP request to the EnableCalls API, and receive call results with a webhook trigger.
- [API reference](https://enablecalls.com/developers/reference.md): Every EnableCalls API endpoint: calls, leads, campaigns, contacts, appointments, do-not-call, webhooks, events, employees and phone numbers, with parameters and fields.

Canonical page: https://enablecalls.com/developers
