Choose a version:

cartCreate

mutation

Creates a new cart.

Arguments

Anchor to inputinput •CartInput: The fields used to create a cart.

Was this section helpful?

Anchor to CartCreatePayload returnsCartCreatePayload returns

Anchor to cartcart •Cart: The new cart.
Anchor to userErrorsuserErrors •[CartUserError!]!non-null: The list of errors that occurred from executing the mutation.
Anchor to warningswarnings •[CartWarning!]!non-null: A list of warnings that occurred during the mutation.

Was this section helpful?

Mutation Reference

mutation cartCreate($input: CartInput) {

cartCreate(input: $input) {

cart {

# Cart fields

}

userErrors {

field

message

}

warnings {

# CartWarning fields

}

Input

{

"input": {

"attributes": [

{

"key": "<your-key>",

"value": "<your-value>"

}

"buyerIdentity": {

"companyLocationId": "gid://shopify/<objectName>/10079785100",

"countryCode": "",

"customerAccessToken": "<your-customerAccessToken>",

"email": "<your-email>",

"phone": "<your-phone>",

"preferences": ""

"delivery": {

"addresses": [

]

"discountCodes": [

"<your-discountCodes>"

"giftCardCodes": [

"<your-giftCardCodes>"

"lines": [

{

"attributes": [

"merchandiseId": "gid://shopify/<objectName>/10079785100",

"quantity": 1,

"sellingPlanId": "gid://shopify/<objectName>/10079785100"

}

"metafields": [

{

"key": "<your-key>",

"type": "<your-type>",

"value": "<your-value>"

}

"note": "<your-note>"

}

{
  "input": {
    "attributes": [
      {
        "key": "<your-key>",
        "value": "<your-value>"
      }
    ],
    "buyerIdentity": {
      "companyLocationId": "gid://shopify/<objectName>/10079785100",
      "countryCode": "",
      "customerAccessToken": "<your-customerAccessToken>",
      "email": "<your-email>",
      "phone": "<your-phone>",
      "preferences": ""
    },
    "delivery": {
      "addresses": [
        ""
      ]
    },
    "discountCodes": [
      "<your-discountCodes>"
    ],
    "giftCardCodes": [
      "<your-giftCardCodes>"
    ],
    "lines": [
      {
        "attributes": [
          ""
        ],
        "merchandiseId": "gid://shopify/<objectName>/10079785100",
        "quantity": 1,
        "sellingPlanId": "gid://shopify/<objectName>/10079785100"
      }
    ],
    "metafields": [
      {
        "key": "<your-key>",
        "type": "<your-type>",
        "value": "<your-value>"
      }
    ],
    "note": "<your-note>"
  }
}

input CartInput {
  attributes: [AttributeInput!]
  buyerIdentity: CartBuyerIdentityInput
  delivery: CartDeliveryInput
  discountCodes: [String!]
  giftCardCodes: [String!]
  lines: [CartLineInput!]
  metafields: [CartInputMetafieldInput!]
  note: String
}

input AttributeInput {
  key: String!
  value: String!
}

input CartBuyerIdentityInput {
  companyLocationId: ID
  countryCode: CountryCode
  customerAccessToken: String
  deliveryAddressPreferences: [DeliveryAddressInput!]
  email: String
  phone: String
  preferences: CartPreferencesInput
}

input CartDeliveryInput {
  addresses: [CartSelectableAddressInput!]
}

input CartLineInput {
  attributes: [AttributeInput!]
  merchandiseId: ID!
  quantity: Int
  sellingPlanId: ID
}

input CartInputMetafieldInput {
  key: String!
  type: String!
  value: String!
}