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

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Create CRM note

> Write a note on one or more records, visible to everyone with access, to named people and groups, or only to the token owner.

Creates a note authored by the token owner. The level decides who reads it: `ALL` shows it to everyone
who may read all its records, `SHARED` to the people and groups named in `grants`, `PRIVATE` only to the
author. Change it afterwards with [Update CRM note](https://collabase.ch/docs/api/crm/update-note.md).

> [!NOTE]
>
> Scope `crm:write`. The token owner needs the right to create notes and to read every record the note is on.

## Request body

**id** `string`

An id of 8 to 64 characters you choose. A repeated call with the same id returns the note it made instead of a second one.

**title** `string` *required*

Up to 200 characters.

**body** `array` *required*

The text as editor blocks, up to 1 MB.

**visibility** `string` (default: ALL)

`ALL`, `SHARED` or `PRIVATE`.

**targetIds** `array` *required*

The records the note is on, 1 to 20.

**grants** `array` (default: \[])

`{ "userId": "..." }` or `{ "groupId": "..." }`, at most 200. Required for `SHARED`, not allowed otherwise.

## Response

The created note, with status `201`.

```bash cURL theme={"dark"}
curl -X POST "https://your-collabase.ch/api/v1/crm/notes" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Call notes",
    "body": [{ "type": "p", "children": [{ "text": "Asked for an offer by December." }] }],
    "visibility": "ALL",
    "targetIds": ["cm3rec0001"]
  }'
```

```json 201 theme={"dark"}
{ "data": { "id": "cm3note001", "title": "Call notes", "visibility": "ALL" } }
```

```json 422 theme={"dark"}
{ "error": { "code": "VALIDATION_ERROR", "message": "Invalid input: grants" } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.