Add or remove leads
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.
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.
X-API-Key<token>Create in the console: Settings → API & webhooks.
campaign_id*stringCampaign ID.
uuidapplication/json- body
Leads to add to or remove from a campaign.
added?array<>Lead IDs to add. Removed leads are added back.
confirmRemovedContacted?ConfirmremovedcontactedRequired to remove leads that were already called; otherwise the request returns 409 campaign_leads_need_confirmation with their IDs.
falseremoved?array<>Lead IDs to remove.
[key: string]?anyOK
application/json- response
What changed on the campaign's lead list.
added?|Leads added, including re-added ones.
campaign?|The campaign.
dialScheduled?|A dial round was scheduled for the new leads.
message?|Human-readable confirmation.
reactivated?|Previously removed leads added back.
removed?|Leads removed.
success?|Always true.
[key: string]?anycurl -X PUT 'https://api.callmitra.ai/api/v1/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08/leads' \ -H 'Content-Type: application/json' \ -d '{ "added": [ "5a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d" ], "removed": []}'{ "added": 1, "campaign": { "id": "3f6c1b2a-7d4e-4a1b-9c2d-5e6f7a8b9c0d" }, "dialScheduled": true, "message": "Updated", "reactivated": 0, "removed": 0, "success": true}Update a campaign PUT
Send only the fields to change. `settings` is merged into the current settings. Changing dialing rules on a running campaign re-plans its next dial round.
Add numbers to do-not-call POST
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`.