createCart

Example Query

mutation ExampleMutation($input: CreateCartInput!) {
  cart {
    createCart(input: $input) {
      cart {
        id
        entityId
        currencyCode
        displayCurrencyCode
        isTaxIncluded
        baseAmount
        baseAmountInDisplayCurrency
        discountedAmount
        discountedAmountInDisplayCurrency
        amount
      }
    }
  }
}

Variables

{
  "input": {
    "lineItems": [
      {
        "quantity": 0,
        "productEntityId": 0,
        "variantEntityId": 0,
        "sku": "example",
        "selectedOptions": {
          "checkboxes": [
            {
              "optionEntityId": 0,
              "optionValueEntityId": 0
            }
          ],
          "dateFields": [
            {
              "optionEntityId": 0,
              "date": "2026-10-12T22:48:12.420Z"
            }
          ],
          "multiLineTextFields": [
            {
              "optionEntityId": 0,
              "text": "example"
            }
          ],
          "multipleChoices": [
            {
              "optionEntityId": 0,
              "optionValueEntityId": 0
            }
          ],
          "numberFields": [
            {
              "optionEntityId": 0,
              "number": 0
            }
          ],
          "textFields": [
            {
              "optionEntityId": 0,
              "text": "example"
            }
          ]
        }
      }
    ],
    "giftCertificates": [
      {
        "name": "example",
        "theme": "BIRTHDAY",
        "amount": "example",
        "quantity": 0,
        "sender": {
          "name": "example",
          "email": "example"
        },
        "recipient": {
          "name": "example",
          "email": "example"
        },
        "message": "example"
      }
    ],
    "currencyCode": "example",
    "locale": "example",
    "externalSource": "example"
  }
}

Example response

{
  "data": {
    "cart": {
      "createCart": {
        "cart": {
          "id": "example",
          "entityId": "example",
          "currencyCode": "example",
          "displayCurrencyCode": "example",
          "isTaxIncluded": true,
          "baseAmount": {
            "currencyCode": null,
            "value": null,
            "formatted": null,
            "formattedV2": null
          },
          "baseAmountInDisplayCurrency": {
            "currencyCode": null,
            "value": null,
            "formatted": null,
            "formattedV2": null
          },
          "discountedAmount": {
            "currencyCode": null,
            "value": null,
            "formatted": null,
            "formattedV2": null
          },
          "discountedAmountInDisplayCurrency": {
            "currencyCode": null,
            "value": null,
            "formatted": null,
            "formattedV2": null
          },
          "amount": {
            "currencyCode": null,
            "value": null,
            "formatted": null,
            "formattedV2": null
          }
        }
      }
    }
  }
}

Creates a cart and generates a cart ID.

Arguments

inputCreateCartInputRequired

Create cart input object

Returns

an optional CreateCartResult

cartCartOptional

The Cart that is created as a result of mutation.