> ## 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 Deal Note

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

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.journeybee.io/api/v1/lead-deals/{dealId}/notes" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json" \
    -d '{"document": {"type": "doc", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Deal moved to negotiation stage"}]}]}}'
  ```
</CodeGroup>

## Path Parameters

<ParamField path="dealId" type="number" required>
  The unique identifier of the deal
</ParamField>

## Request Body Schema

Same as lead notes - rich text document with attachments and mentions support.

## Notes

* Requires API key with `write_access` permission
* Deal notes trigger webhook events for commission tracking
* Partner companies may receive notifications for important deal updates