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`.
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.
X-API-Key<token>Create in the console: Settings → API & webhooks.
Idempotency-Key?stringAny unique string up to 255 characters. Retrying with the same key and body within 24 hours returns the first result instead of acting twice.
length <= 255application/json- body
Numbers to put on the do-not-call list.
phones*PhonesIndian mobile numbers, one per line or separated by commas. Invalid ones are skipped.
8 <= length <= 20000reason?ReasonWhy, shown on each entry.
length <= 255""OK
application/json- 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?SuccessAlways true on a 2xx response.
trueupdated?|Existing leads newly marked do-not-call.
[key: string]?anycurl -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"}'{ "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}Add or remove leads PUT
New leads are dialed automatically if the campaign is running. Removed leads keep their call history. A lead already on the campaign, or a number already on it, is skipped.
List do-not-call numbers GET
The 500 most recently changed leads marked do-not-call, newest first. The list stops at 500 entries; `hasMore` is true when older entries were left out. The dialer never calls these numbers.