---
title: Discounts API - New Buy X Get Y option - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/discounts-api-new-buy-x-get-y-option'
  md: 'https://shopify.dev/changelog/discounts-api-new-buy-x-get-y-option.md'
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2019-12-02T14:30:16-05:00'
  postedAt: '2019-10-06T00:00:00-04:00'
  updatedAt: '2024-02-02T10:04:55-05:00'
  effectiveAt: '2019-10-06T00:00:00-04:00'
---

October 6, 2019

Tags:

* API

# Discounts API - New Buy X Get Y option

Buy X Get Y discounts now support setting a minimum purchase amount to qualify for the discount. This option can be used instead of requiring a specific quantity of items a customer must buy. Use this new option to create promotions such as “Spend $100, get a free gift,” or “Spend $200 on skincare, get 50% off a water bottle.”

This option is available as both an automatic discount or a discount code using the Discounts GraphQL API.

You can learn more about this new option in our [Discounts API Guide](https://help.shopify.com/en/api/guides/discounts) in the Shopify Help Center.