---
title: "Add a comment to an order"
method: POST
path: "/orders/{orderId}/comments"
tags: ["Admin Sales: Orders"]
---

# Add a comment to an order

`POST /orders/{orderId}/comments`

## Request

- Base URL: `http://localhost:8000/api/admin`
- URL: `http://localhost:8000/api/admin/orders/{orderId}/comments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-admin-api/docs/orders/:orderId/comments/post.ts> (a function with typed inputs; its response is checked against the schema)

Persists an order comment. When `customerNotified=true` core listeners send the customer email.

## Path parameters

- `orderId` integer, required

## Request body

- object

## Response `201`

AdminOrderComment resource created

- AdminOrderComment: Admin order comments. REST : POST /api/admin/orders/{id}/comments (create) GET /api/admin/orders/{id}/comments (cursor list, newest first) GraphQL: createAdminOrderComment mutation + adminOrderComments query collection.
  - `id` integer, nullable
  - `orderId` integer, nullable
  - `comment` string, nullable
  - `customerNotified` boolean, nullable
  - `createdAt` string, nullable
  - `updatedAt` string, nullable

## Other responses

- `400`: Invalid input
- `422`: Validation Error

---

[API](https://skmtc.dev/bagisto/apis/bagisto-admin-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-admin-api/revisions/3198f11be70f?raw)