Skip to content

Create-Order Helpers

The Create-Order Helpers are read-only panels that support an admin placing an order on a customer's behalf. When building an order from the admin side, you often want to seed it from what the customer already has — their live cart, their wishlist, or things they bought before. These queries surface exactly that, so the admin can pick products into a draft cart without hunting through the catalog. They back the sidebar panels of the admin Create-Order screen.

How they fit the Create-Order flow

The full order-building flow lives under Sales → Orders (create a draft cart, add items, save addresses, choose shipping/payment, place the order). These helpers are the supporting reads for that flow — they tell you what to add. The one write here, Create Draft Cart, is the entry point that starts a fresh draft cart for the customer.

HelperWhat it shows
Active Cart ItemsThe items currently in the customer's own active storefront cart.
Wishlist ItemsThe products on the customer's wishlist.
Recent Order ItemsThe most recently ordered products (up to the last five distinct products).
Create Draft CartStarts a new empty draft cart for the customer to build the order in.

Operations in this menu

ActionOperation
Active Cart ItemsadminCustomerCartItems(customerId:) query
Wishlist ItemsadminCustomerWishlistItems(customerId:) query
Recent Order ItemsadminCustomerRecentOrderItems(customerId:) query
Create Draft CartcreateAdminDraftCart mutation

All operations require an admin Bearer token — see Authentication.

Released under the MIT License.