Update Order is a WordPress ability from WooCommerce — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Update Order
WriteUpdate an existing WooCommerce order's status, addresses, line items, or payment details.
Requires the WooCommerce plugin active on WordPress 6.9+, with the experimental 'mcp_integration' feature flag enabled (WooCommerce > Settings > Advanced > Features). Abilities are only registered for requests hitting WooCommerce's own /woocommerce/mcp REST endpoint, and each request must authenticate with a WooCommerce REST API key (consumer_key:consumer_secret) sent via the X-MCP-API-Key header over HTTPS — the key's read/write permission scope must match the HTTP method used.
What it does
This ability updates an order by dispatching a PUT request through wc/v3/orders/{id}, reusing the same editable order fields available on create — status, currency, customer_id, billing/shipping, payment method, and line_items — plus a 'manual_update' flag that WooCommerce's v3 order schema adds so any resulting order note is recorded as added by a user rather than the system. The factory adds and requires an 'id' field to identify the target order before building the REST route. The response returns the updated order record.
See it in action
You ask your AI assistant
"Update order #3021 to mark it as 'completed' and add a note that it shipped via courier."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | Yes | Unique identifier of the order to update. |
| status | string | No | Order status to set (e.g. processing, completed, cancelled, refunded). |
| customer_note | string | No | Note left by the customer during checkout. |
| billing | object | No | Billing address object to update. |
| shipping | object | No | Shipping address object to update. |
| line_items | array | No | Array of line items to set on the order. |
| manual_update | boolean | No | When true, marks the resulting order note as added by a user rather than the system. Defaults to false. |
Returns
The updated order object reflecting the applied changes.
Permission
Registered as a write (PUT) operation. Requires a WooCommerce REST API key sent via the X-MCP-API-Key header over HTTPS with 'write' or 'read_write' permission scope.
More WooCommerce abilities
Create Order
Create a new WooCommerce order with customer, billing/shipping, and line item details.
Create Product
Create a new WooCommerce product with a name, price, description, and other catalog attributes.
Delete Product
Permanently delete a product from the WooCommerce catalog.
Get Order
Fetch full details for a single WooCommerce order by its ID.
Get Product
Fetch full details for a single WooCommerce product by its ID.
List Orders
List and filter WooCommerce orders by status, customer, product, or date range.