---
title: "DiscountCodeFreeShippingInput"
description: "The input fields for creating or updating a free shipping code."
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-free-shipping-input'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/discounts-and-marketing/inputs/discount-code-free-shipping-input.md'
---
# DiscountCodeFreeShippingInput

The input fields for creating or updating a free shipping code.

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

* `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

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

* `destination`

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

  The list of destinations where the discount applies. 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.

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

* `maximumShippingPrice`

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

  The maximum shipping fee eligible for the discount. If `null` or omitted, there is no limit on the shipping fee.

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

* `minimumRequirement`

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

  The minimum item quantity or order subtotal required for the discount. If `null` or omitted, there is no minimum requirement.

## Argument from

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

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