---
title: "Create Note"
method: POST
path: "/team-messaging/v1/chats/{chatId}/notes"
tags: ["Notes"]
---

# Create Note

`POST /team-messaging/v1/chats/{chatId}/notes`

Creates a new note in the specified chat.

## Path parameters

- `chatId` string, required

## Request body

- TMCreateNoteRequest
  - `title` string, required — Title of a note. Max allowed length is 250 characters
  - `body` string — Contents of a note; HTML markup text. Max allowed length is 1048576 characters (1 Mb).

## Response `200`

OK

- TMNoteInfo
  - `id` string — Internal identifier of a note
  - `title` string — Title of a note
  - `chatIds` string[] — Internal identifiers of the chat(s) where the note is posted or shared.
  - `preview` string — Preview of a note (first 150 characters of a body)
  - `creator` TMCreatorInfo — Note creator information
    - `id` string — Internal identifier of a user who created a note/task
  - `lastModifiedBy` LastModifiedByInfo — Note last modification information
    - `id` string — Internal identifier of the user who last updated the note
  - `lockedBy` LockedByInfo — Returned for the note being edited (locked) at the current moment. Information on the user editing the note
    - `id` string — Internal identifier of the user editing the note
  - `status` 'Active' | 'Draft' — Note publishing status. Any note is created in 'Draft' status. After it is posted it becomes 'Active'
  - `creationTime` string, date-time — Creation time
  - `lastModifiedTime` string, date-time — Datetime of the note last update
  - `type` 'Note'

## Other responses

- `400` — Some of the parameters are missing or have invalid format
- `403` — You do not have permissions to create note in the specified group.
- `404` — Group not found.

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)