--- title: applyCouponToCart mutation description: The applyCouponToCart mutation applies a predefined coupon code to the specified cart. Valid coupon codes are defined in cart price rules. --- # applyCouponToCart mutation The `applyCouponToCart` mutation applies a predefined coupon code to the specified cart. Valid coupon codes are defined in cart price rules. ## Syntax `mutation: {applyCouponToCart(input: ApplyCouponToCartInput) {ApplyCouponToCartOutput}}` ## Reference The `applyCouponToCart` reference provides detailed information about the types and fields defined in this mutation. * [Adobe Commerce as a Cloud Service](/reference/graphql/saas/mutations.md#applycoupontocart) * [On-Premises/Cloud](/reference/graphql/latest/mutations.md#applycoupontocart) ## Example usage The following example applies the coupon code `H2O` to the cart. For this coupon to be valid, the Affirm Water Bottle (`sku`: 24-UG06) must be in the cart. **Request:** ```graphql mutation { applyCouponToCart( input: { cart_id: "IeTUiU0oCXjm0uRqGCOuhQ2AuQatogjG", coupon_code: "H20" } ) { cart { itemsV2 { items { product { name } quantity } total_count page_info { page_size current_page total_pages } } applied_coupons { code } prices { grand_total{ value currency } } } } } ``` **Response:** ```json { "data": { "applyCouponToCart": { "cart": { "itemsV2": { "items": [ { "product": { "name": "Gold Membership" }, "quantity": 2 }, { "product": { "name": "Strive Shoulder Pack" }, "quantity": 1 }, { "product": { "name": "Affirm Water Bottle " }, "quantity": 1 } ], "total_count": 3, "page_info": { "page_size": 20, "current_page": 1, "total_pages": 1 } }, "applied_coupons": { "code": "H20" }, "prices": { "grand_total": { "value": 134.08, "currency": "USD" } } } } } } ``` ## Errors | Error | Description | | --- | --- | | `A coupon is already applied to the cart. Please remove it to apply another` | The value specified in the `coupon_code` argument has already applied to cart. Use [removeCouponFromCart](remove-coupon.md) to remove the current coupon and to apply another. | | `Cart does not contain products.` | The coupon cannot be applied to an empty cart. | | `Could not find a cart with ID "XXX"` | The specified `cart_id` value does not exist in the `quote_id_mask` table. | | `Required parameter "coupon_code" is missing` | The required `coupon_code` argument contains an empty value. | | `The coupon code isn't valid. Verify the code and try again.` | The entered coupon code is not applicable. Check the existing shopping cart price rules for details. | | `The current user cannot perform operations on cart XXX` | An unauthorized user (guest) tried to add the product into a customer's cart, or an authorized user (customer) tried to add the product into the cart of another customer. |