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

# Create a note

`POST /notes`

Attach a note to a parent record. Provide **exactly one** parent reference param
alongside the note - e.g. `company_id`, `contact_id`, `job_id`, `invoice_id`,
`work_order_id` (sales order), `quote_id`, `sales_lead_id`. The parent model is
derived from the `*_id` key name.

## Query parameters

- `company_id` string, uuid

## Request body

- NoteWrite
  - `note` object, required
    - `content` string, required
    - `category_id` string, uuid
    - `email_thread_id` string
    - `email_thread_subject` string

## Response `200`

Created.

- Note
  - `id` string, uuid
  - `content` string
  - `createdAt` string, date-time
  - `emailThreadId` string, nullable
  - `emailThreadSubject` string, nullable
  - `categoryName` string, nullable
  - `categoryId` string, uuid, nullable
  - `createdBy` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string

## Other responses

- `422` — Unprocessable entity - field errors keyed by attribute.

---

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