Move Wishlist Item to Cart
Move a product from the customer's wishlist directly into their shopping cart. The item is removed from the wishlist once it is successfully added to the cart.
Endpoint
POST /api/shop/move-wishlist-to-cartsRequest Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | application/json |
X-STOREFRONT-KEY | Yes | Your storefront API key |
Authorization | Yes | Customer Bearer token (Bearer <accessToken>) |
Request Body
json
{
"wishlistItemId": 77,
"quantity": 2
}| Field | Type | Required | Description |
|---|---|---|---|
wishlistItemId | integer | Yes | The numeric ID of the wishlist item to move. |
quantity | integer | No | Number of units to add to the cart. Defaults to 1. |
Response Fields (200 OK)
The response is the updated cart. Key fields include:
| Field | Type | Description |
|---|---|---|
id | integer | Cart ID |
itemsCount | integer | Number of distinct items in the cart |
itemsQty | integer | Total quantity across all cart items |
subtotal | decimal | Items subtotal |
grandTotal | decimal | Cart grand total |
formattedGrandTotal | string | Localised grand total |
couponCode | string | Applied coupon code (if any) |
success | boolean | true when the move succeeded |
message | string | Confirmation message |
TIP
The cart payload mirrors the standard cart response shape. See Get Cart for the full field set; confirm exact values against the live endpoint for your installation.
Validation
wishlistItemIdmust reference a wishlist item owned by the authenticated customer.quantitymust be a positive integer.- Configurable products may require their options to be selected.
Use Cases
- "Move to Cart" buttons on the wishlist page
- Convert saved-for-later items into active cart items