---
title: "Create a note"
method: POST
path: "/v1/notes"
tags: ["notes"]
---

# Create a note

`POST /v1/notes`

Creates a note and attaches it to one or more prospects. To create a note for a single prospect, provide <code>prospectId</code>. To create the same note for multiple prospects in one request, provide <code>prospectIds</code> as an array — the response will include a results array with the outcome for each prospect, so a failure for one prospect does not affect the others.

## Request body

- CreateNoteDto
  - `content` string, required — The content of the note. Supports plain text and HTML.
  - `visibility` '1' | '2', required — Who can see this note. Use "1" for public (visible to all team members) or "2" for private (visible only to you).
  - `prospectIds` string[], required — List of prospect IDs to attach the note to. Pass a single-element array for a single prospect, or multiple IDs to attach the same note to several prospects in one request.
  - `attachmentIds` string[] — IDs of attachments to associate with this note. Upload via POST /v1/notes/attachments to obtain each attachmentId.
  - `status` '0' | '1' — The status of the note. Use "0" for draft or "1" for published. Defaults to "1" (published) if not provided.

## Response `201`

Note created successfully

- unknown

## Other responses

- `400` — 1001: Invalid prospect Id<br><br>1001: Invalid token<br><br>
- `500` — 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) · [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/saleshandy/develop-with-saleshandy/revisions/fdaa0f2dcdfb/schema)