---
title: "Create chat note"
method: POST
path: "/v2/messages/note"
tags: ["Messages"]
---

# Create chat note

`POST /v2/messages/note`

Create an internal note (annotation) on a conversation. The note appears in the conversation history identically to a note created in the UI, scoped to the authenticated owner. Internal notes are never sent to the contact. Note: @mentions in the content are stored verbatim but do not trigger mention notifications.

## Headers

- `api-token` string, required

## Request body

- object
  - `chat_id` string, uuid, required — UUID of the conversation (chat) to add the note to
  - `content` string, required — Text content of the note (1-4096 characters)
  - `author` string — Optional display name shown as the note author in the conversation history. Defaults to "API" when omitted.

## Response `201`

Note created

- object
  - `status` integer
  - `data` object
    - `success` boolean
    - `id` string, uuid — UUID of the created note message
    - `chat_id` string, uuid
    - `content` string
    - `author` string
    - `type` 'NOTE'
    - `created_at` string, date-time

## Other responses

- `400` — Validation error
- `401` — Authentication error - invalid or missing api-token
- `403` — The attendance API feature is not enabled for your account
- `404` — Chat not found

---

[API](https://skmtc.net/clint/apis/clint-api.md) · [All operations](https://skmtc.net/clint/apis/clint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clint/clint-api/revisions/12b8f9eff943/schema)