Add order note

Add a private note for your team or a note the customer sees and is emailed.

POST https://cotlet.dev/api/v1/woocommerce/orders/{order_id}/note

write Confirm

Adds a note to an order. By default the note is private and only staff see it. With customer_note set to true, WooCommerce shows the note to the customer and notifies them. Notes cannot be edited by this tool, so a wrong customer note stays on the order. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_order_note
NameTypeDescription
order_id integer required integer Order ID from list_orders.
note string required string The note text.
customer_note boolean boolean true shows the note to the customer and notifies them. Default: false.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/woocommerce/orders/1/note \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"note":"note"}'
Python
result = client.call("woocommerce", "add_order_note", {"order_id":1,"note":"note"})
Node.js
const result = await cotlet.call('woocommerce', 'add_order_note', {"order_id":1,"note":"note"});
CLI
cotlet call woocommerce add_order_note --data '{"order_id":1,"note":"note"}'

Example response

JSON

{
  "note_id": 9131,
  "order_id": 1043,
  "note": "Tracking number 1Z999AA10123456791",
  "customer_note": true,
  "date_created": "2026-10-15T08:03:00Z"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.