createCart | BigCommerce Developer Center

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

{
  "input": {
    "lineItems": [
      {
        "quantity": 0,
        "productEntityId": 0,
        "variantEntityId": 0,
        "sku": "example",
        "selectedOptions": {
          "checkboxes": [
            {
              "optionEntityId": 0,
              "optionValueEntityId": 0
            }
          ],
          "dateFields": [
            {
              "optionEntityId": 0,
              "date": "DateTime"
            }
          ],
          "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": "BigDecimal",
        "quantity": 0,
        "sender": {
          "name": "example",
          "email": "example"
        },
        "recipient": {
          "name": "example",
          "email": "example"
        },
        "message": "example"
      }
    ],
    "currencyCode": "example",
    "locale": "example"
  }
}

{
  "data": {
    "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

inputObjectRequired

Create cart input object

Returns

an optional Object

cartObject

The Cart that is created as a result of mutation.

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": "DateTime"
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": "BigDecimal",
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	}