API referenceLead notes
Add a note
A note added with an API key is authored `api` and is kept like a note a person wrote.
POST
A note added with an API key is authored api and is kept like a note a person wrote.
header
X-API-Key<token>Create in the console: Settings → API & webhooks.
lead_id*Lead IdLead ID.
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
length <= 255application/json- body
A new note.
body*BodyNote text, up to 10000 characters.
Length
1 <= length <= 10000kind?Kindnote, or follow_up for a to-do.
Default
"note"Value in
"note""follow_up"OK
application/json- response
The note after the change.
note?|The note.
notesCount?|Live notes on the lead (on create).
success?|Always true.
[key: string]?anycurl -X POST 'https://api.callmitra.ai/api/v1/leads/string/notes' \ -H 'Content-Type: application/json' \ -d '{ "body": "Asked for a call back after 6pm.", "kind": "note"}'Example Response
{ "note": { "authorKind": "api", "body": "Asked for a call back after 6pm.", "createdAt": "2026-05-04T10:15:00Z", "id": "8a1f3c2e-5b7d-4e0a-9c61-2d4b8e7f0a13", "kind": "note", "leadId": "3f2c9d6e-1a4b-4c8d-9e0f-7a6b5c4d3e21", "pinned": false, "updatedAt": "2026-05-04T10:15:00Z", "version": 1 }, "notesCount": 4, "success": true}