addConfigurableProductsToCart mutation

Use the addConfigurableProductsToCart mutation to add configurable products to a specific cart.

Syntax

1
2
3
4
5
6
7
mutation {
  addConfigurableProductsToCart(
    input: AddConfigurableProductsToCartInput
  ) {
    AddConfigurableProductsToCartOutput
  }
}

Example usage

The following example adds two black Teton Pullover Hoodies size extra-small to the specified shopping cart. The cart_id used in this example was generated by creating an empty cart.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
mutation {
  addConfigurableProductsToCart(
    input: {
      cart_id: "4JQaNVJokOpFxrykGVvYrjhiNv9qt31C"
      cart_items: [
        {
          parent_sku: "MH02"
          data: {
            quantity: 2
            sku: "MH02-XS-Black"
          }
        }
      ]
    }
  ) {
    cart {
      items {
        id
        quantity
        product {
          name
          sku
        }
        ... on ConfigurableCartItem {
          configurable_options {
            option_label
          }
        }
      }
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "data": {
    "addConfigurableProductsToCart": {
      "cart": {
        "items": [
          {
            "id": "5",
            "quantity": 2,
            "product": {
              "name": "Teton Pullover Hoodie",
              "sku": "MH02"
            },
            "configurable_options": [
              {
                "option_label": "Color"
              },
              {
                "option_label": "Size"
              }
            ]
          }
        ]
      }
    }
  }
}

Input attributes

AddConfigurableProductsToCartInput object

The AddConfigurableProductsToCartInput object contains the following attributes:

ConfigurableProductCartItemInput object

The ConfigurableProductCartItemInput object contains the following attributes:

CustomizableOptionInput object

The CustomizableOptionInput object contains the following attributes:

CartItemInput object

The CartItemInput object must contain the following attributes:

Output attributes

The AddConfigurableProductsToCartOutput object contains the Cart object.

Cart object

Cart query output provides more information about the Cart object.

Errors

Related topics

• Configurable product data types