Skip to Content
CallMitraDocs
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
/api/v1/leads/{lead_id}/notes

A note added with an API key is authored api and is kept like a note a person wrote.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

lead_id*Lead Id

Lead ID.

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

A new note.

body*Body

Note text, up to 10000 characters.

Length1 <= length <= 10000
kind?Kind

note, or follow_up for a to-do.

Default"note"
Value in"note""follow_up"

Response Body

OK

application/json
  1. response

The note after the change.

note?|

The note.

notesCount?|

Live notes on the lead (on create).

success?|

Always true.

[key: string]?any
Example Request
curl -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}