---
title: "Send Private Notes"
method: POST
path: "/note/create"
tags: ["note"]
---

# Send Private Notes

`POST /note/create`

This endpoint is used to send private notes to a chat. 

- A private note is only visible on Periskope and not sent to a chat on WhatsApp.
- When a user is mentioned in body of a private note using `@<email>`, a task is automatically created and assigned to that member.

#### Response

The response is a JSON note object. Refer to [the note object here](/api-reference/objects/the-note-object)

## Headers

- `x-phone` string

## Request body

- object
  - `chat_id` string, required — - For groups, enter the chat_id of the group. This will be a string that ends with @g.us - For 1-1 chats, enter the country_code + number of the recipient e.g. [919537851844@c.us](https://mailto:919537851844@c.us) (The @c.us is optional)
  - `message` string — The text body or caption. You can use basic markdown formatting supported by WhatsApp e.g. * for bold, and _ for italic, etc
  - `media` object — Media object containing file information and content Note: You must specify either `filedata` or `url`
    - `url` string — Public URL that hosts the content to be sent
    - `filedata` string — Raw bytes of the file, represented in base64
    - `filename` string, required — The filename of the media
    - `mimetype` string, required — The MIME type of the media file
  - `reply_to` string — To reply to a message, add the WA message_id or private note message_id in this field

## Response `200`

Text Note / Media Note / Reply Note

- object — The response is a JSON object with the following properties: - `success`: Status of the request - `data`: A object of private note created. Refer to [the private note object](/api-reference/objects/the-note-object) here

---

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