Notes

Notes are free-text annotations attached to a lead. Note IDs use the prefix note_ (e.g., note_01234567-89ab-cdef-0123-456789abcdef). All timestamps are Unix seconds.

---

List Notes

GET /leads/{id}/notes

Response 200 OK:

[
  {
    "id": "note_01234567-89ab-cdef-0123-456789abcdef",
    "lead_id": "cl_...",
    "content": "Spoke with CEO, very interested in Pro plan.",
    "created_at": 1703520000,
    "updated_at": 1703520000
  }
]

---

Create Note

POST /leads/{id}/notes

{ "content": "Follow-up scheduled for next week." }

Response 201 Created: Full note object.

---

Update Note

PUT /notes/{note_id}

{ "content": "Follow-up completed. Deal closed." }

Response 200 OK: Updated note object.

Ownership is verified — you can only update notes that belong to your leads. Returns 404 if the note doesn’t exist or belongs to a different account.

---

Delete Note

DELETE /notes/{note_id}

Response 204 No Content.