Skip to Content
CallMitraDocs
API referenceCalls

Call a lead now

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.

POST
/api/v1/leads/{lead_id}/call-now

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.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

lead_id*Lead Id

Lead ID.

Response Body

OK

application/json
  1. 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?Success

Always true on a 2xx response.

Defaulttrue
[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/leads/string/call-now'
Example Response
{  "call": {    "campaignId": "3f6c1b2a-7d4e-4a1b-9c2d-5e6f7a8b9c0d",    "campaignName": "December renewals",    "id": "c4d5e6f7-a8b9-4c0d-9e1f-2a3b4c5d6e7f",    "leadId": "5d2f8a1e-3b4c-4d6e-9f0a-1b2c3d4e5f60",    "leadName": "Asha Rao",    "phoneNumber": "+919876543210",    "phoneNumberId": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",    "status": "initiated"  },  "success": true}