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?
- In the dashboard, open Developers and create a key with full access. Copy it: it is shown once.
- Find your employee's id with
GET /employees. The employee needs its own phone number. - Send the request below to your own phone first. Add
"dry_run": trueto run every check without calling anyone. - Subscribe a webhook to
call.completedandcall.not_connected, or readGET /calls/{id}until the status is final.
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):
{
"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. - Every write accepts
"dry_run": trueand anIdempotency-Keyheader. See Errors and limits. - 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.
- The machine-readable spec is at https://api.enablecalls.com/v1/openapi.json, and every endpoint is in the API 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.
Ready to try it? Sign in and open Developers to create a key, or ask us about your integration.