Add Item to Cart

Adds a product to the draft cart. Each product type needs its own selection fields in addition to productId and quantity. The fields below are typed and work identically over REST and GraphQL:

Product type	Fields (besides productId, quantity)
Simple / Virtual	—
Configurable	selectedConfigurableOption — the chosen variant's product id
Downloadable	links — array of downloadable-link ids
Grouped	groupedQuantities — array of { productId, quantity }
Bundle	bundleOptions — array of { optionId, productIds, quantity }
Booking	not supported in admin Create-Order (returns 400)

Example bundle body:

{
  "productId": 142,
  "quantity": 1,
  "bundleOptions": [
    { "optionId": 5, "productIds": [10], "quantity": 1 },
    { "optionId": 6, "productIds": [12], "quantity": 1 }
  ]
}

REST also accepts the raw storefront keys

Because REST forwards the whole body to the cart, it additionally accepts the storefront snake_case shape — selected_configurable_option, bundle_options (map of optionId => [productIds]), bundle_option_qty, qty (map of productId => quantity), links. The typed fields above are recommended because they also work over GraphQL.

Endpoint

Endpoint	Method
/api/admin/carts/{id}/items	POST