---
title: "Create a new note on a parent document"
method: POST
path: "/api/notes"
tags: ["Note"]
---

# Create a new note on a parent document

`POST /api/notes`

## Request body

- NoteCreateDto — Represents a note on a document
  - `parentId` string, required — Unique identifier of the object to which the note is attached Can be 24 or 36 characters, depending on parent type
  - `parentType` 'salesOrder' | 'purchaseOrder' | 'quote' | 'invoice', required — Note parent document type
  - `body` string, required — Note text
  - `mentions` string[], nullable — User Ids to tag in the note. Please reference /api/users endpoints.

## Response `200`

Note created

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Validation issues with input

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)