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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Create contact note

> Creates a note attached to one contact.

`highlevel.createContactNote` creates a note attached to one contact.

```ts automations/highlevel-create-contact-note.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { highlevel } from "automate.ax/highlevel"

export default automation("Create contact note", () => {
  markSignificant(
    highlevel.createContactNote({
      contactId: "sx6wyHhbFdRXh302LLNR",
      body: "lorem ipsum",
    }),
  )
})
```

## Input

| Field       | Type      | Required | Description                 |
| ----------- | --------- | -------- | --------------------------- |
| `contactId` | `string`  | Yes      | HighLevel contact id value. |
| `userId`    | `string`  | No       | HighLevel user id value.    |
| `body`      | `string`  | Yes      | HighLevel body value.       |
| `title`     | `string`  | No       | HighLevel title value.      |
| `color`     | `string`  | No       | HighLevel color value.      |
| `pinned`    | `boolean` | No       | HighLevel pinned value.     |

Automate.ax supplies the connected sub-account's location ID. Optional second argument `{ account }` selects a named HighLevel binding.

## Output

| Field  | Type     | Required | Description           |
| ------ | -------- | -------- | --------------------- |
| `note` | `object` | No       | HighLevel note value. |

HighLevel may return `note.userId` as `null` when an integration creates the note.

This action calls `POST /contacts/{contactId}/notes` with HighLevel API version `2021-07-28` and requires `contacts.write`. HighLevel validation and permission errors fail the action. Rate limits honor the provider's retry timing. Automate.ax does not automatically replay this create or send operation after an indeterminate transport failure.