> 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.

# applyCheckoutCoupon

GraphQL MUTATION

Applies a checkout coupon.

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

## GraphQL Schema

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

## Variables

```json
{
  "input": {
    "checkoutEntityId": "example",
    "data": {
      "couponCode": "example"
    },
    "version": 0
  }
}
```