What arguments does addSimpleProductsToCart accept?

The addSimpleProductsToCart mutation accepts 1 argument: input (AddSimpleProductsToCartInput).

What does addSimpleProductsToCart return?

addSimpleProductsToCart returns AddSimpleProductsToCartOutput.

Does addSimpleProductsToCart require authentication?

addSimpleProductsToCart requires an Authorization header with a Bearer customer token. Obtain the token by calling the generateCustomerToken mutation with the customer's email and password.

MageSmith

MutationQuote · Magento 2.4.9

addSimpleProductsToCart

Q: What does the addSimpleProductsToCart mutation do in Magento 2 GraphQL?

addSimpleProductsToCart is a Magento 2 GraphQL mutation in the Quote module. Add one or more simple products to the specified cart. We recommend using addProductsToCart instead. It returns AddSimpleProductsToCartOutput and requires an Authorization header (Bearer customer token).

addSimpleProductsToCart is a Magento 2 GraphQL mutation in the Quote module. Add one or more simple products to the specified cart. We recommend using addProductsToCart instead. It returns AddSimpleProductsToCartOutput and requires an Authorization header (Bearer customer token).

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

AddSimpleProductsToCartOutput

Resolver class

Magento\QuoteGraphQl\Model\Resolver\AddSimpleProductsToCart

Arguments

input AddSimpleProductsToCartInput

An input object that defines which simple 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 {
  addSimpleProductsToCart {
    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
      }
    }
  }
}