MageSmith
MutationQuote · Magento 2.4.9

addProductsToCart

addProductsToCart is a Magento 2 GraphQL mutation in the Quote module. Add any type of product to the cart. It returns AddProductsToCartOutput and requires an Authorization header (Bearer customer token).

Last verified: against Magento 2.4.9.

Returns

AddProductsToCartOutput

Resolver class

Magento\QuoteGraphQl\Model\Resolver\AddProductsToCart

Arguments

cartId String! Required

The cart ID of the shopper.

cartItems [CartItemInput!]! Required

An array that defines the products to add to the cart.

Example request

Auto-generated from the SDL — paste-ready against your store's /graphql endpoint. Replace the host, store code, and any required values before running.

Headers

Content-Type
application/json
Store
default store view code; use 'default' for the single-store baseline
Authorization
Bearer <CUSTOMER_TOKEN> obtain from generateCustomerToken mutation

Query

mutation ($cartId: String!, $cartItems: [CartItemInput!]!) {
  addProductsToCart(cartId: $cartId, cartItems: $cartItems) {
    cart {
      gift_message {
        to
        from
        message
      }
      id
      items {
        not_available_message
        id
        uid
        quantity
        is_available
        prices { ... }
        product { ... }
        errors { ... }
      }
      itemsV2 {
        items { ... }
        page_info { ... }
        total_count
      }
      applied_coupon {
        code
      }
      applied_coupons {
        code
      }
      email
      shipping_addresses {
        available_shipping_methods { ... }
        selected_shipping_method { ... }
        customer_notes
        items_weight
        cart_items { ... }
        cart_items_v2 { ... }
        same_as_billing
        pickup_location_code
      }
      billing_address {
        customer_notes
      }
      available_payment_methods {
        is_deferred
        code
        title
      }
      selected_payment_method {
        code
        title
        purchase_order_number
      }
      prices {
        grand_total { ... }
        grand_total_excluding_tax { ... }
        subtotal_including_tax { ... }
        subtotal_excluding_tax { ... }
        discount { ... }
        subtotal_with_discount_excluding_tax { ... }
        applied_taxes { ... }
        discounts { ... }
      }
      total_quantity
      is_virtual
      rules {
        uid
      }
    }
    user_errors {
      message
      code
    }
  }
}

Variables

{
  "cartId": "",
  "cartItems": [
    {
      "quantity": 0,
      "sku": ""
    }
  ]
}

Every Magento dev tool, in one hosted workspace.

Free to sign up. Nothing to install. Drafts, audits, and projects saved across every tool.