---
title: "Changes to Create a new Promotion."
method: POST
path: "/promotions.json"
---

# Changes to Create a new Promotion.

`POST /promotions.json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 12 revisions.

- **2026-10-15** `53dc9f2c1329`: 11 breaking, 7 warning, 29 info

## Changes

- **2026-10-15** `53dc9f2c1329`: 11 breaking, 7 warning, 29 info
  - request property `promotion/buys_at_least` was restricted to a list of enum values
  - request property `promotion/customers` was restricted to a list of enum values
  - request property `promotion/discount_target` was restricted to a list of enum values
  - request property `promotion/lasts` was restricted to a list of enum values
  - request property `promotion/type` was restricted to a list of enum values
  - the request property `promotion/discount_target` became required
  - the request property `promotion/name` became required
  - the `promotion/begins_at` request property format changed from no format to `date`
  - the `promotion/expires_at` request property format changed from no format to `date`
  - the response property `promotion/begins_at` became nullable for the status `200`
  - the response property `promotion/expires_at` became nullable for the status `200`
  - removed the optional property `promotion/lasts` from the response with the `200` status
  - added the new `active` enum value to the `promotion/status` response property for the response status `200`
  - added the new `buy_x_get_y` enum value to the `promotion/discount_target` response property for the response status `200`
  - added the new `categories` enum value to the `promotion/discount_target` response property for the response status `200`
  - added the new `expired` enum value to the `promotion/status` response property for the response status `200`
  - added the new `order` enum value to the `promotion/discount_target` response property for the response status `200`
  - added the new `shipping` enum value to the `promotion/discount_target` response property for the response status `200`
  - added the new optional request property `promotion/coupons/items/customer_limit`
  - added the new optional request property `promotion/coupons/items/id`
  - added the new `all` enum value to the request property `promotion/customers`
  - added the new `both` enum value to the request property `promotion/lasts`
  - added the new `buy_x_get_y` enum value to the request property `promotion/discount_target`
  - added the new `categories` enum value to the request property `promotion/customers`
  - added the new `categories` enum value to the request property `promotion/discount_target`
  - added the new `date` enum value to the request property `promotion/lasts`
  - added the new `fix` enum value to the request property `promotion/type`
  - added the new `guests` enum value to the request property `promotion/customers`
  - added the new `loggedin` enum value to the request property `promotion/customers`
  - added the new `max_times_used` enum value to the request property `promotion/lasts`
  - added the new `none` enum value to the request property `promotion/buys_at_least`
  - added the new `none` enum value to the request property `promotion/lasts`
  - added the new `nopurchases` enum value to the request property `promotion/customers`
  - added the new `not_in_categories` enum value to the request property `promotion/customers`
  - added the new `order` enum value to the request property `promotion/discount_target`
  - added the new `percentage` enum value to the request property `promotion/type`
  - added the new `price` enum value to the request property `promotion/buys_at_least`
  - added the new `qty` enum value to the request property `promotion/buys_at_least`
  - added the new `shipping` enum value to the request property `promotion/discount_target`
  - added the new `single_item` enum value to the request property `promotion/buys_at_least`
  - …7 more

---

[Operation](https://skmtc.dev/jumpseller/apis/jumpseller-api/docs/promotions.json/post.md) - [API](https://skmtc.dev/jumpseller/apis/jumpseller-api.md) - [Page](https://skmtc.dev/jumpseller/apis/jumpseller-api/changes/promotions.json/post)