---
title: "Create Note"
method: POST
path: "/notes"
tags: ["Notes"]
---

# Create Note

`POST /notes`

Create a note attached to a customer chat or a WA Group chat. Use `to` + `from` for customer chats, or `groupId` for WA Group chats. Rate limit: 60 requests per minute per organization.

## Request body

- CreatePublicNoteDto
  - `note` string, required — Text content of the note
  - `groupId` string — The groupId of the WA Group. Use this instead of `to`/`from` when creating a note for a group chat.
  - `from` string, phone — The WABA phone number with country code. Required when not using groupId.
  - `to` string, phone — The customer phone number with country code. Required when not using groupId.
  - `entities` object[] — Optional entities (e.g., users) mentioned in the note that should receive notifications
    - `type` string — Type of the entity
    - `id` string — Unique identifier of the entity

## Response `201`

Note created successfully

- PublicNoteResponseDto
  - `id` string — Unique identifier of the note
  - `note` string — Text content of the note
  - `createdBy` string — Name of the user who created the note
  - `updatedBy` string — Name of the user who last updated the note
  - `dateCreated` string, date-time — Timestamp when the note was created
  - `dateUpdated` string, date-time — Timestamp when the note was last updated

## Other responses

- `400` — Incorrect payload
- `401` — Unauthorized
- `404` — WABA, customer or chat not found

---

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