Skip to Content
CallMitraDocs
API referenceDo not call

Add numbers to do-not-call

Marks existing leads with these numbers as do-not-call and creates entries for new numbers. Numbers that are not Indian mobiles are skipped; if none is valid the request fails with `dnc_no_valid_numbers`.

POST
/api/v1/leads/dnc

Marks existing leads with these numbers as do-not-call and creates entries for new numbers. Numbers that are not Indian mobiles are skipped; if none is valid the request fails with dnc_no_valid_numbers.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Header Parameters

Idempotency-Key?string

Any unique string up to 255 characters. Retrying with the same key and body within 24 hours returns the first result instead of acting twice.

Lengthlength <= 255

Request Body

application/json
  1. body

Numbers to put on the do-not-call list.

phones*Phones

Indian mobile numbers, one per line or separated by commas. Invalid ones are skipped.

Length8 <= length <= 20000
reason?Reason

Why, shown on each entry.

Lengthlength <= 255
Default""

Response Body

OK

application/json
  1. response

Numbers now on do-not-call.

added?|

New do-not-call entries created for unknown numbers.

entries?array<>|

The leads for every valid number sent.

success?Success

Always true on a 2xx response.

Defaulttrue
updated?|

Existing leads newly marked do-not-call.

[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/leads/dnc' \  -H 'Content-Type: application/json' \  -d '{  "phones": "9876543210\n+919812345678",  "reason": "Asked not to be called"}'
Example Response
{  "added": 1,  "entries": [    {      "createdAt": "2026-11-01T09:30:00Z",      "dncOptOut": true,      "dncReason": "Asked not to be called",      "dncUpdatedAt": "2026-11-15T10:00:00Z",      "id": "5d2f8a1e-3b4c-4d6e-9f0a-1b2c3d4e5f60",      "name": "Asha Rao",      "phone": "+919876543210",      "status": "new"    },    {      "createdAt": "2026-11-01T09:30:00Z",      "dncOptOut": true,      "dncReason": "Asked not to be called",      "dncUpdatedAt": "2026-11-15T10:00:00Z",      "id": "6e3a9b2f-4c5d-4e7f-8a1b-2c3d4e5f6a71",      "name": "",      "phone": "+919812345678",      "status": "new"    }  ],  "success": true,  "updated": 1}