Add order note

Add a free-text note to an order.

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

write Confirm

Adds a note under Add Note on the order page, for things like accessibility needs or an instruction for your team. Billetto shows the note to anyone who opens the order and prints it in downloaded reports, and its help article does not say whether the buyer sees it, so write nothing you would not say to the buyer. By default you confirm each call; you can switch that off for this tool.

Parameters

Parameters: add_order_note
NameTypeDescription
order_id string required string Order ID from list_orders.
note string required string The note text.

Request

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

Example response

JSON

{
  "order_id": "9035127",
  "notes": [
    {
      "note": "Needs step-free entrance",
      "added_at": "2026-10-23T10:12:44+02:00"
    }
  ]
}

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.