Create a lead
Creates one lead and optionally adds it to campaigns. The phone is stored in E.164 form (a 10-digit number gets `+91`, as in a CSV upload); a number that cannot be read is refused with `invalid_phone_number`. The number is not checked for duplicates. Values that could not be saved as sent (an unknown status, a mistyped field) come back in `warnings`.
Creates one lead and optionally adds it to campaigns. The phone is stored in E.164 form (a 10-digit number gets +91, as in a CSV upload); a number that cannot be read is refused with invalid_phone_number. The number is not checked for duplicates. Values that could not be saved as sent (an unknown status, a mistyped field) come back in warnings.
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
A new lead. Every field is optional; send at least a phone number to call it.
attributes?Profile facts, for example {"city": "Pune"}. Typed by your lead fields.
campaignIds?array<string>Add the lead to these campaigns.
company?CompanyCompany name.
""email?EmailEmail address.
""leadSourceId?LeadsourceidID of an existing lead source.
""name?NameFull name.
""notes?NotesSaved as the lead's first note.
""phone?PhonePhone number, saved in E.164 form: +919876543210, 9876543210 and 098765 43210 all save as +919876543210 (a number without a country code is taken as Indian). A value that is not a phone number returns 422 invalid_phone_number.
""source?SourceFree-text source label, for example website.
""status?StatusPipeline status key. An unknown key saves as new with a warning.
"new"title?|Job title.
""OK
application/json- response
The lead after the change.
lead*The lead.
success?SuccessAlways true on a 2xx response.
truewarnings?array<>|Values saved differently than sent (for example an unknown status).
[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/leads/' \ -H 'Content-Type: application/json' \ -d '{ "attributes": { "city": "Pune" }, "company": "Rao Traders", "email": "[email protected]", "name": "Asha Rao", "phone": "9876543210"}'{ "lead": { "attributes": { "city": "Pune" }, "callAttempts": 0, "callStatus": "not_called", "campaignIds": [], "campaignNames": [], "company": "Rao Traders", "createdAt": "2026-11-15T10:00:00+00:00", "dncOptOut": false, "email": "[email protected]", "id": "6f1c2a9e-3b7d-4c55-9a0e-1d2f3a4b5c6d", "name": "Asha Rao", "phone": "+919876543210", "source": "website", "status": "new", "tags": [], "title": "Owner", "updatedAt": "2026-11-15T10:00:00+00:00" }, "success": true, "warnings": []}