---
title: "Add a note to an order"
method: POST
path: "/shop/orders/{orderId}/notes"
tags: ["Orders"]
---

# Add a note to an order

`POST /shop/orders/{orderId}/notes`

Add a new note to an order. The note will be attributed to the authenticated
user, who is recorded as the `created_by` user on the resulting `OrderNote`.

## Request body

- object
  - `content` string, required — The contents of the note. HTML is not permitted — submit plain text only. Use notes to capture operational context for the order (for example, special requests from the guest, or an internal note for the front desk).

## Response `201`

The order note was successfully retrieved.

- object
  - `data` OrderNote, required — A note relating to an order.
    - `id` string, required
    - `content` string, required — The contents of the note.
    - `order_id` string — The order this note belongs too
    - `created_at` string, date-time — The date and time the note was created.
    - `created_by` object
      - `id` string, required — The ID of the user who added the note.
      - `name` string, required — The name of the user who added the note.
    - `created_by_id` string — The ID of the user who added the note.

## Other responses

- `404` — The resource couldn't be found
- `422` — The request didn't pass validation

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)