---
title: "Create Discount"
method: POST
path: "/merchant/discount"
tags: ["Discount"]
---

# Create Discount

`POST /merchant/discount`

Create a new discount. Configure type (percentage or fixed), value, applicable vendors or menu items, expiry date, usage limits, and minimum order amount.

## Request body

- object
  - `reference` string, required — A unique identifier for the discount.
  - `title` string, required — The title of the discount that will be displayed to users.
  - `description` string, required — A brief description of the discount and how it can be used.
  - `type` string, required — The type of discount; flat_fee or percentage_off
  - `value` string, required — The value of the discount, which corresponds to the percentage or amount off.
  - `category` 'price_slash_off_all_orders' | 'price_slash_off_menu', required — The category under which the discount falls, such as "price_slash_off_all_orders"
  - `expiry_date` string, required — The date when the discount will expire, formatted as YYYY-MM-DD.
  - `maximum_usage_times` integer, required — The maximum number of times this discount can be used.
  - `vendor_references` string[], required — An array of vendor references that this discount applies to
  - `minimum_order_amount` integer, required — The minimum order amount required to use the discount
  - `capped_amount` integer — The maximum discount amount that can be applied. Required when category is 'price_slash_off_all_orders'; forbidden for other categories.
  - `menu_references` string[] — An array of menu references that this discount applies to

## Response `200`

---

[API](https://skmtc.dev/chowdeck/apis/chowdeck-api.md) · [All operations](https://skmtc.dev/chowdeck/apis/chowdeck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chowdeck/chowdeck-api/revisions/5830cc8467d8/schema)