---
title: "DiscountCodeBxgyInput"
description: "The input fields for creating or updating a Buy X Get Y code discount."
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-code-bxgy-input'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-code-bxgy-input.md'
---
# DiscountCodeBxgyInput

The input fields for creating or updating a Buy X Get Y code discount.

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Input

## Input Fields

* `code`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  The code to use the discount.

* `customerSelection`

  [DiscountCustomerSelectionInput](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-customer-selection-input.md)

  The customers eligible for the discount. If `null` or omitted during an update, the original value remains unchanged.

* `startsAt`

  [Date](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/date.md)

  The date and time when the discount starts.
  
  

* `customerBuys`

  [DiscountCustomerBuysInput](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-customer-buys-input.md)

  Eligible items for the discount and the quantity of each item that customers must purchase.

* `usesPerOrderLimit`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  The maximum number of times the discount can be applied per order. If  `null` or omitted, there is no limit.

* `title`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  The title of the discount.

* `appliesTimesPerCustomer`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  The maximum number of times a single customer can use the discount. If `null` or omitted, there is no limit.    
  Value range: 1–99,999,999
  

* `endsAt`

  [Date](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/date.md)

  The date and time when the discount ends. If `null` or omitted, the discount has no expiration date.

* `combinesWith`

  [DiscountCombinesWithInput](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-combines-with-input.md)

  The discount types that can be combined with the discount. If the field is `null`, an empty object (`{}`), or is omitted, the discount cannot be combined with any other discounts.

* `customerGets`

  [DiscountCustomerGetsInput](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-customer-gets-input.md)

  Eligible items for the discount, the quantity of each item, and the total value of the discount.

* `usageLimit`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  The maximum number of times the discount can be used. If `null` or omitted, there is no total usage limit.        
  Value range: 1–99,999,999

## Argument from

* [Mutation](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/mutations/discount-code-bxgy-create.md).discountCodeBxgyCreate

* [Mutation](https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/mutations/discount-code-bxgy-update.md).discountCodeBxgyUpdate