createCart

Example Query

1 mutation ExampleMutation($input: CreateCartInput!) {
2   cart {
3     createCart(input: $input) {
4       cart {
5         id
6         entityId
7         currencyCode
8         displayCurrencyCode
9         isTaxIncluded
10         baseAmount
11         baseAmountInDisplayCurrency
12         discountedAmount
13         discountedAmountInDisplayCurrency
14         amount
15       }
16     }
17   }
18 }

Variables

1 {
2   "input": {
3     "lineItems": [
4       {
5         "quantity": 0,
6         "productEntityId": 0,
7         "variantEntityId": 0,
8         "sku": "example",
9         "selectedOptions": {
10           "checkboxes": [
11             {
12               "optionEntityId": 0,
13               "optionValueEntityId": 0
14             }
15           ],
16           "dateFields": [
17             {
18               "optionEntityId": 0,
19               "date": "2026-06-15T17:44:06.860Z"
20             }
21           ],
22           "multiLineTextFields": [
23             {
24               "optionEntityId": 0,
25               "text": "example"
26             }
27           ],
28           "multipleChoices": [
29             {
30               "optionEntityId": 0,
31               "optionValueEntityId": 0
32             }
33           ],
34           "numberFields": [
35             {
36               "optionEntityId": 0,
37               "number": 0
38             }
39           ],
40           "textFields": [
41             {
42               "optionEntityId": 0,
43               "text": "example"
44             }
45           ]
46         }
47       }
48     ],
49     "giftCertificates": [
50       {
51         "name": "example",
52         "theme": "BIRTHDAY",
53         "amount": "example",
54         "quantity": 0,
55         "sender": {
56           "name": "example",
57           "email": "example"
58         },
59         "recipient": {
60           "name": "example",
61           "email": "example"
62         },
63         "message": "example"
64       }
65     ],
66     "currencyCode": "example",
67     "locale": "example"
68   }
69 }

Example response

1 {
2   "data": {
3     "cart": {
4       "createCart": {
5         "cart": {
6           "id": "example",
7           "entityId": "example",
8           "currencyCode": "example",
9           "displayCurrencyCode": "example",
10           "isTaxIncluded": true,
11           "baseAmount": {
12             "currencyCode": null,
13             "value": null,
14             "formatted": null,
15             "formattedV2": null
16           },
17           "baseAmountInDisplayCurrency": {
18             "currencyCode": null,
19             "value": null,
20             "formatted": null,
21             "formattedV2": null
22           },
23           "discountedAmount": {
24             "currencyCode": null,
25             "value": null,
26             "formatted": null,
27             "formattedV2": null
28           },
29           "discountedAmountInDisplayCurrency": {
30             "currencyCode": null,
31             "value": null,
32             "formatted": null,
33             "formattedV2": null
34           },
35           "amount": {
36             "currencyCode": null,
37             "value": null,
38             "formatted": null,
39             "formattedV2": null
40           }
41         }
42       }
43     }
44   }
45 }

Creates a cart and generates a cart ID.

Arguments

inputCreateCartInputRequired

Create cart input object

Returns

an optional CreateCartResult

cartCart

The Cart that is created as a result of mutation.