discountCodeBxgyCreate mutation

Creates a BXGY code discount.

Required access

Apps must have write_discounts access scope.

On this page

• Interactive example
• Arguments
• DiscountCodeBxgyInput fields
• Return fields

Interactive example

This is an example mutation query. Use the embedded interactive tool below to edit the query.

Hint: use Ctrl + Space for autocompleting fields.

<font style="color:#1F61A0;">codeDiscountNode</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">id</font>
<font style="color:#555555;">}</font>
<font style="color:#1F61A0;">userErrors</font> <font style="color:#555555;">{</font>
  <font style="color:#1F61A0;">code</font>
  <font style="color:#1F61A0;">extraInfo</font>
  <font style="color:#1F61A0;">field</font>
  <font style="color:#1F61A0;">message</font>
<font style="color:#555555;">}</font>

Arguments

DiscountCodeBxgyInput fields

• appliesOncePerCustomer ([Boolean](https://shopify.dev/docs/admin-api/graphql/reference/scalar#boolean-2021-01))
  Whether the discount can be applied only once per customer.
• code ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The code to use the discount.
• customerBuys ([DiscountCustomerBuysInput](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcustomerbuysinput))
  The qualifying items and the quantity of each one that the customer has to buy to be eligible for the discount.
• customerGets ([DiscountCustomerGetsInput](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcustomergetsinput))
  The qualifying items in an order, the quantity of each one, and the total value of the discount.
• customerSelection ([DiscountCustomerSelectionInput](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcustomerselectioninput))
  The customers that can use the discount.
• endsAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date and time when the discount ends. For open-ended discounts, use null.
• startsAt ([DateTime](https://shopify.dev/docs/admin-api/graphql/reference/scalar#datetime-2021-01))
  The date and time when the discount starts.
• title ([String](https://shopify.dev/docs/admin-api/graphql/reference/scalar#string-2021-01))
  The title of the discount.
• usageLimit ([Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01))
  The maximum number of times that the discount can be used. For open-ended discounts, use null.
• usesPerOrderLimit ([Int](https://shopify.dev/docs/admin-api/graphql/reference/scalar#int-2021-01))
  The maximum number of times that the discount can be applied to an order.

Return fields

• codeDiscountNode ([DiscountCodeNode](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountcodenode))
  The created code discount.
• userErrors ([[DiscountUserError!]!](https://shopify.dev/docs/admin-api/graphql/reference/discounts-and-marketing/discountusererror))
  List of errors that occurred executing the mutation.