assignCustomerToGuestCart mutation

The assignCustomerToGuestCart mutation merges a logged-in customer’s shopping cart into the specified guest cart. The mutation inactivates the customer’s shopping cart and moves the products to the guest cart. The guest cart is then assigned to the customer.

The masked_id of the guest cart contains a new value. The quote_id remains the same.

This mutation requires a valid customer authentication token.

Use the mergeCarts mutation to transfer the contents of a guest cart into a customer’s cart.

Syntax

1
2
3
4
5
6
7
mutation {
    assignCustomerToGuestCart(
        cart_id: String!
    ) {
        Cart!
    }
}

Example usage

In the following example, the customer and guest carts each contain one item. The mutation merges the customer’s cart to the guest cart. As a result, the guest cart contains two items.

Request:

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  assignCustomerToGuestCart(
    cart_id: "MDYKgqIdWMKr7VD1zlYwxrB7kuX8lR5s"
  ) {
    items {
      quantity
      product {
        sku
      }
    }
  }
}

Response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "data": {
    "assignCustomerToGuestCart": {
      "items": [
        {
          "quantity": 1,
          "product": {
            "sku": "customer_item"
          }
        },
        {
          "quantity": 1,
          "product": {
            "sku": "guest_item"
          }
        }
      ]
    }
  }
}

Input attributes

Output attributes

The assignCustomerToGuestCart mutation returns a Cart object.

Cart object

Cart query output provides more information about the Cart object.

Errors