---
title: "Changes to Create Coupon"
method: POST
path: "/v1/coupons"
---

# Changes to Create Coupon

`POST /v1/coupons`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 41 revisions.

- **2026-10-28** `84e35f2954bf`: 3 warning, 2 info
- **2026-10-15** `d06893be93cc`: 1 warning, 1 info
- **2026-10-05** `0ef278347679`: 2 info
- **2026-09-30** `b76beb6145b6`: 1 warning
- **2026-09-29** `9f8df83795d3`: 1 info
- **2026-09-23** `1816e2044c07`: 2 breaking, 4 warning, 5 info
- **2026-08-25** `fbb6b66272c8`: 1 info
- **2026-08-18** `ef61f771db1d`: 4 warning, 1 info

## Changes

- **2026-10-28** `84e35f2954bf`: 3 warning, 2 info
  - added the new `store` enum value to the `items/items/nested_items/items/quantity_expression/tokens/items/type` response property for the response status `201`
  - added the new `store` enum value to the `items/items/quantity_expression/tokens/items/type` response property for the response status `201`
  - added the new `store` enum value to the `requirements_expression/tokens/items/type` response property for the response status `201`
  - added the new `store` enum value to the request property `requirements_expression/tokens/items/type`
  - added the optional property `items/items/nested_items_choices` to the response with the `201` status
- **2026-10-15** `d06893be93cc`: 1 warning, 1 info
  - added the new `rolling` enum value to the `items/items/type` response property for the response status `201`
  - added the optional property `items/items/nested_items/items/is_bonus_target` to the response with the `201` status
- **2026-10-05** `0ef278347679`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-30** `b76beb6145b6`: 1 warning
  - added the new `pick_one` enum value to the `items/items/type` response property for the response status `201`
- **2026-09-29** `9f8df83795d3`: 1 info
  - response property `items/items/view_option` deprecated
- **2026-09-23** `1816e2044c07`: 2 breaking, 4 warning, 5 info
  - the response property `items/items/nested_items/items/quantity_expression/name` became optional for the status `201`
  - the response property `items/items/quantity_expression/name` became optional for the status `201`
  - added the new `function` enum value to the `items/items/nested_items/items/quantity_expression/tokens/items/type` response property for the response status `201`
  - added the new `function` enum value to the `items/items/quantity_expression/tokens/items/type` response property for the response status `201`
  - added the new `function` enum value to the `requirements_expression/tokens/items/type` response property for the response status `201`
  - added the new `piggy_bank` enum value to the `items/items/type` response property for the response status `201`
  - added the new optional request property `requirements_expression/name`
  - added the new `function` enum value to the request property `requirements_expression/tokens/items/type`
  - added the optional property `items/items/nested_items/items/quantity_expression/variables` to the response with the `201` status
  - added the optional property `items/items/quantity_expression/variables` to the response with the `201` status
  - added the optional property `requirements_expression/name` to the response with the `201` status
- **2026-08-25** `fbb6b66272c8`: 1 info
  - added the optional property `items/items/nested_items/items/quantity_expression` to the response with the `201` status
- **2026-08-18** `ef61f771db1d`: 4 warning, 1 info
  - the `applicable_item_ids/items/` request property's maxLength was set to `32`
  - the `category_id` request property's maxLength was set to `32`
  - the `creator_program/creator_id` request property's maxLength was set to `32`
  - the `free_items/items/items/item_id` request property's maxLength was set to `32`
  - added the optional property `items/items/quantity_expression` to the response with the `201` status

---

[Operation](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/docs/v1/coupons/post.md) - [API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) - [Page](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/changes/v1/coupons/post)