---
title: "Changes to Create promotion"
method: POST
path: "/api/v1/promotions"
---

# Changes to Create promotion

`POST /api/v1/promotions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-07-07** `a3b4750a505f` — 9 breaking, 17 info
- **2026-07-07** `84194c31ab85` — 15 breaking, 11 warning

## Changes

- **2026-07-07** `a3b4750a505f` — 9 breaking, 17 info
  - added the new required request property `accumulation`
  - added the new required request property `benefit`
  - added the new required request property `code`
  - added the new required request property `conditions`
  - added the new required request property `eligibility`
  - added the new required request property `item_restrictions`
  - added the new required request property `name`
  - added the new required request property `usage_limits`
  - added the new required request property `validity`
  - added the new optional request property `description`
  - added the new optional request property `metadata`
  - added the required property `accumulation` to the response with the `201` status
  - added the required property `active` to the response with the `201` status
  - added the required property `benefit` to the response with the `201` status
  - added the required property `code` to the response with the `201` status
  - added the required property `conditions` to the response with the `201` status
  - added the required property `created_at` to the response with the `201` status
  - added the required property `description` to the response with the `201` status
  - added the required property `eligibility` to the response with the `201` status
  - added the required property `id` to the response with the `201` status
  - added the required property `item_restrictions` to the response with the `201` status
  - added the required property `metadata` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
  - added the required property `updated_at` to the response with the `201` status
  - added the required property `usage_limits` to the response with the `201` status
  - added the required property `validity` to the response with the `201` status
- **2026-07-07** `84194c31ab85` — 15 breaking, 11 warning
  - removed the required property `accumulation` from the response with the `201` status
  - removed the required property `active` from the response with the `201` status
  - removed the required property `benefit` from the response with the `201` status
  - removed the required property `code` from the response with the `201` status
  - removed the required property `conditions` from the response with the `201` status
  - removed the required property `created_at` from the response with the `201` status
  - removed the required property `description` from the response with the `201` status
  - removed the required property `eligibility` from the response with the `201` status
  - removed the required property `id` from the response with the `201` status
  - removed the required property `item_restrictions` from the response with the `201` status
  - removed the required property `metadata` from the response with the `201` status
  - removed the required property `name` from the response with the `201` status
  - removed the required property `updated_at` from the response with the `201` status
  - removed the required property `usage_limits` from the response with the `201` status
  - removed the required property `validity` from the response with the `201` status
  - removed the request property `accumulation`
  - removed the request property `benefit`
  - removed the request property `code`
  - removed the request property `conditions`
  - removed the request property `description`
  - removed the request property `eligibility`
  - removed the request property `item_restrictions`
  - removed the request property `metadata`
  - removed the request property `name`
  - removed the request property `usage_limits`
  - removed the request property `validity`

---

[Operation](https://skmtc.dev/kruzer-corp/apis/oms-api/docs/api/v1/promotions/post.md) · [API](https://skmtc.dev/kruzer-corp/apis/oms-api.md) · [Page](https://skmtc.dev/kruzer-corp/apis/oms-api/changes/api/v1/promotions/post)