Call a lead in a campaign now
Places the call immediately, outside the dial schedule, with the campaign's agent and numbers. Numbers on do-not-call are never dialed. To call any number without a campaign, use `POST /calls`.
Places the call immediately, outside the dial schedule, with the campaign's agent and numbers. Numbers on do-not-call are never dialed. To call any number without a campaign, use POST /calls.
X-API-Key<token>Create in the console: Settings → API & webhooks.
application/json- body
campaignId*CampaignidA running campaign the lead belongs to; its agent and numbers are used.
leadId*LeadidLead to call. It must be on the campaign and not on do-not-call.
OK
application/json- response
A call was handed to the carrier. Progress arrives on GET /calls/{callId} and webhooks.
call*The call that was placed.
sipResponse?|The carrier's answer to the dial request; fields vary by carrier.
success?SuccessAlways true on a 2xx response.
true[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/instant/call-now' \ -H 'Content-Type: application/json' \ -d '{ "campaignId": "e3f4a5b6-c7d8-4e9f-a0b1-c2d3e4f5a6b7", "leadId": "b2a7c9d1-6e3f-4a8b-9c0d-1e2f3a4b5c6d"}'{ "call": { "campaignId": "e3f4a5b6-c7d8-4e9f-a0b1-c2d3e4f5a6b7", "campaignName": "November renewals", "id": "8c1e5b7a-2d4f-4e9a-b6c3-1f0a9d8e7b65", "leadId": "b2a7c9d1-6e3f-4a8b-9c0d-1e2f3a4b5c6d", "leadName": "Asha Verma", "phoneNumber": "+919812345678", "phoneNumberId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "providerCallId": "a1b2c3d4-e5f6-7a8b-9c0d-e1f2a3b4c5d6", "status": "initiated" }, "success": true}Call a lead now POST
Calls the lead right away through the first running campaign it belongs to, using that campaign's agent and caller ID. The lead's do-not-call flag, the campaign's daily cap and your concurrent call limit still apply; each refusal has its own error code.
Place a call POST
Calls `to` now with the agent, outside any campaign schedule. The number is saved as a lead (or matched to an existing one) and dialed through the agent's instant campaign, one call at a time per agent. Numbers on your do-not-call list are never dialed. The response means the carrier accepted the dial; follow the call with `GET /calls/{callId}` or call webhooks. Send an `Idempotency-Key` header so a retried request does not call twice. Each request dials once. A call that is not answered, is busy or times out is not redialed, and a refused dial is not queued for later: place another call if you want a second attempt. The one exception is a callback the callee asks for and the agent books during the call; that scheduled callback is placed at the agreed time. Toll-fraud limits: `to` must be in your workspace's home country (from your billing address; India when none is set) unless support enabled more countries, and each workspace may place a fixed number of calls per UTC day through this endpoint (`daily_call_limit_reached` with `Retry-After` until 00:00 UTC). Calling hours (TRAI / local quiet hours) are not enforced on direct calls: checking the time of day at the callee is your responsibility. Campaigns apply their own calling windows.