# CartInput

Input for creating a new cart

## Input Definition

```graphql
input CartInput {
  lines: [CartLineInput]
  buyerIdentity: BuyerIdentityInput
}
```

## Fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| lines | [CartLineInput] | No | A list of merchandise lines to add to the cart |
| buyerIdentity | BuyerIdentityInput | No | The buyer identity associated with the cart |

## Example

```graphql
mutation CreateCart($input: CartInput!) {
  createCart(input: $input) {
    cart {
      id
      lines {
        id
        quantity
      }
    }
  }
}

# Variables
{
  "input": {
    "lines": [
      {
        "productId": 12345,
        "quantity": 2
      }
    ],
    "buyerIdentity": {
      "email": "customer@example.com",
      "countryCode": "US"
    }
  }
}
```

## Related Types

- [CartLineInput](/docs/api/input-types/cart-line-input)
- [BuyerIdentityInput](/docs/api/input-types/buyer-identity-input)