---
title: "Create Coupon"
method: POST
path: "/api/v2/coupons"
tags: ["Coupons"]
---

# Create Coupon

`POST /api/v2/coupons`

Create a new coupon with discount details and active/inactive status.

## Request body

- CouponCreate
  - `name` string, required — Name of the coupon.
  - `discount_value` union, required — Discount value of the coupon (either percentage or fixed).
    - number
    - string
  - `currency` 'SAR' | 'USD' | 'EUR' | 'GBP' | 'AED' | 'BHD' | 'KWD' | 'OMR' | 'QAR' — ISO 4217 currency codes supported by Moyasar. Includes all currencies supported by Moyasar payment gateway.
  - `is_percentage` boolean — True if the discount is a percentage, False if it is a fixed amount.
  - `is_active` boolean — Indicates if the coupon is active upon creation.

## Response `200`

Successful Response

- CouponDto
  - `created_at` string, date-time — Creation timestamp of the object.
  - `updated_at` string, date-time, nullable — Last modification timestamp of the object.
  - `id` string, uuid4 — Unique identifier (UUID) of the coupon
  - `name` string — Name of the coupon.
  - `discount_value` string — Discount value of the coupon (either percentage or fixed).
  - `currency` 'SAR' | 'USD' | 'EUR' | 'GBP' | 'AED' | 'BHD' | 'KWD' | 'OMR' | 'QAR' — ISO 4217 currency codes supported by Moyasar. Includes all currencies supported by Moyasar payment gateway.
  - `is_percentage` boolean — True if the discount is a percentage, False if it is a fixed amount.
  - `is_active` boolean — Indicates if the coupon is currently active.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)