---
title: "CustomerRewardCreateInput"
description: "The input fields for creating and issuing a customer reward."
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/member-system/inputs/customer-reward-create-input'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/member-system/inputs/customer-reward-create-input.md'
---
# CustomerRewardCreateInput

The input fields for creating and issuing a customer reward.

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

## Input Fields

* `buyerIds`

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

  A list of IDs of customers to whom the reward applies.<br/>Maximum size: 100

* `businessId`

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

  The unique identifier for the reward issuance.<br/> Maximum length: 64

* `rewardType`

  [RewardTypeCreate!](https://developer.shopline.com/docs/admin-graph-ql-api/member-system/objects/reward-type-create.md)

  The discount type of the reward.

* `benefitsDetails`

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

  The discount value of the reward.<br/> Example: Setting `rewardType` to `PERCENTAGE_DISCOUNT` and `benefitsDetails` to `50` indicates a 50% discount.

* `rewardUsageInstructionType`

  [RewardUsageInstructionTypeCreate!](https://developer.shopline.com/docs/admin-graph-ql-api/member-system/objects/reward-usage-instruction-type-create.md)

  The type of the reward usage threshold.

* `rewardUsageInstructionValue`

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

  The value of the reward usage threshold.<br/>Example: Setting  `rewardType` to `PERCENTAGE_DISCOUNT`, `rewardUsageInstructionType` to `MIN_ITEM_QUANTITY`, and `rewardUsageInstructionValue` to `2` indicates that a customer needs to purchase at least 2 items to use this reward.

* `usageLimits`

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

  The reward usage limit. Pass `null` or omit if there is no reward usage limit.

* `autoStackLimit`

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

  Whether the reward can be used with automatic discounts. 
  - `true`:  The reward can be used with automatic discounts.
  - `false`: The reward cannot be used with automatic discounts.

* `codeStackLimit`

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

  Whether the reward can be used with discount codes. 
  - `true`: The reward can be used with discount codes.
  - `false`:  The reward cannot be used with discount codes.

* `rewardExpiryTime`

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

  The date and time when the reward expires. Format: <a href="https://www.iso.org/iso-8601-date-and-time-format.html">ISO 8601</a>. Pass `null` or omit if the reward is valid indefinitely.
  <br/>Example: `2026-06-10T19:49:00.000Z`

## Argument from

* [Mutation](https://developer.shopline.com/docs/admin-graph-ql-api/member-system/mutations/customer-reward-create.md).customerRewardCreate