> ## Documentation Index
> Fetch the complete documentation index at: https://docs.journeybee.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Lead Note

> Create a new note for a lead with rich text content, attachments, and user mentions

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.journeybee.io/api/v1/leads/{leadId}/notes" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json" \
    -d '{"document": {"type": "doc", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Follow up call scheduled"}]}]}}'
  ```
</CodeGroup>

## Path Parameters

<ParamField path="leadId" type="number" required>
  The unique identifier of the lead
</ParamField>

## Request Body Schema

<ParamField body="document" type="object" required>
  Rich text document content in ProseMirror format
</ParamField>

<ParamField body="attachments" type="array">
  Array of file attachment UUIDs
</ParamField>

<ParamField body="mentions" type="array">
  Array of user IDs to mention (triggers notifications)
</ParamField>

## Response Schema

<ResponseField name="id" type="number">
  The created note ID
</ResponseField>

## Example Response

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": 123
  }
  ```
</ResponseExample>

## Notes

* Requires API key with `write_access` permission
* Supports rich text formatting, attachments, and user mentions
* Mentioned users receive notifications