update_order
Edit metadata on an existing Shopify order: email, tags, internal note, or custom attributes. Use to fix typos, add notes, or apply internal tags.
Instructions
Update an existing order's metadata: email, tags, internal note, or custom attributes. Most order fields are immutable post-creation in Shopify (line items, totals, customer-of-record can't be changed via the Admin API after the fact) — for those, use refund_order or cancel_order to back out, then create a corrected order. Tags and customAttributes are full replacements: read the current values first if you want to merge rather than replace. Use when fixing a typo'd email, adding a fulfillment-team note, or attaching internal segmentation tags.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Order GID or numeric ID to update. Most order fields are immutable post-creation; only the metadata fields below can be edited via this tool. | |
| No | New customer email. Pass to update or fix the contact email. | ||
| tags | No | New tag set. REPLACES the existing tags entirely. Read current tags first if you want to merge rather than replace. | |
| note | No | New internal staff note. Replaces any prior note. | |
| customAttributes | No | Custom attributes (cart attributes / order notes). Replaces the entire set if provided. |