> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# createCheckout

GraphQL MUTATION

Creates a checkout and generates a checkout ID.

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/storefront/mutations/checkout/create-checkout

## GraphQL Schema

```graphql
mutation ExampleMutation($input: CreateCheckoutInput!) {
  checkout {
    createCheckout(input: $input) {
      checkout {
        id
        entityId
        currencyCode
        displayCurrencyCode
        billingAddress
        cart
        shippingConsignments
        shippingCostTotal
        shippingCostTotalInDisplayCurrency
        shippingCostBeforeDiscount
      }
      errors
    }
  }
}
```

## Variables

```json
{
  "input": {
    "lineItems": [
      {
        "quantity": 0,
        "productEntityId": 0,
        "variantEntityId": 0,
        "sku": "example",
        "selectedOptions": {
          "checkboxes": [
            {
              "optionEntityId": 0,
              "optionValueEntityId": 0
            }
          ],
          "dateFields": [
            {
              "optionEntityId": 0,
              "date": "2026-10-30T22:30:28.637Z"
            }
          ],
          "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": "example",
        "quantity": 0,
        "sender": {
          "name": "example",
          "email": "example"
        },
        "recipient": {
          "name": "example",
          "email": "example"
        },
        "message": "example"
      }
    ],
    "currencyCode": "example",
    "locale": "example",
    "shippingConsignments": [
      {
        "address": {
          "firstName": "example",
          "lastName": "example",
          "email": "example",
          "company": "example",
          "address1": "example",
          "address2": "example",
          "city": "example",
          "stateOrProvince": "example",
          "stateOrProvinceCode": "example",
          "countryCode": "example"
        },
        "selectRecommendedOption": true,
        "shippingOptionSelectionStrategy": "LEAST_EXPENSIVE"
      }
    ],
    "billingAddress": {
      "firstName": "example",
      "lastName": "example",
      "email": "example",
      "company": "example",
      "address1": "example",
      "address2": "example",
      "city": "example",
      "stateOrProvince": "example",
      "stateOrProvinceCode": "example",
      "countryCode": "example"
    },
    "coupons": [
      "example"
    ],
    "externalSource": "example"
  }
}
```