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 endpoints 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.

Endpoints in this menu

ActionEndpoint
Active Cart ItemsGET /api/admin/customers/{customerId}/cart-items
Wishlist ItemsGET /api/admin/customers/{customerId}/wishlist-items
Recent Order ItemsGET /api/admin/customers/{customerId}/recent-order-items
Create Draft CartPOST /api/admin/customers/{customerId}/draft-carts

All endpoints require an admin Bearer token — see Authentication.

Released under the MIT License.