---
title: "Create a Coupon"
method: POST
path: "/v1/discounts"
---

# Create a Coupon

`POST /v1/discounts`

This API creates coupons that can be used to avail discounts on the invoice.

## Headers

- `Accept` string, required
- `Content-Type` string

## Request body

- object
  - `duration` 'once' | 'repeating' | 'forever', required — The duration for which the subscription invoices are discounted from the time a coupon is redeemed or applied.
  - `name` string, required — Name of the coupon.
  - `amount_off` integer — A number that represents the amount to be subtracted from an invoice total.
  - `percent_off` integer — A number that represents the discount that will be applied when a coupon is used.
  - `discount_id` string — An ID that refers to a coupon when applying to a customer's subscription.
  - `currency` string — Three-letter ISO currency code, in lowercase.
  - `duration_in_months` integer — The duration for which the subscription invoices are discounted from the time a coupon is redeemed or applied.
  - `max_redemptions` integer — Maximum number of times a coupon can be used on subscriptions.
  - `redeem_by` string — Timestamp specifying the last time at which the coupon can be redeemed. After the 'redeem_by date', the coupon can no longer be applied to new subscriptions.

## Response `201`

201

- object
  - `data` object
    - `object` string
    - `discount_id` string
    - `amount_off` integer
    - `percent_off` unknown
    - `duration` string
    - `duration_in_months` unknown
    - `max_redemptions` unknown
    - `redeem_by` unknown
    - `times_redeemed` unknown
    - `status` string
    - `name` string
    - `created_at` integer
    - `updated_at` integer
    - `id` string
  - `meta` object
    - `include` unknown[]
      - unknown
    - `custom` unknown[]
      - unknown

## Other responses

- `422` — 422

---

[API](https://skmtc.net/payarc/apis/payarc-sandbox.md) · [All operations](https://skmtc.net/payarc/apis/payarc-sandbox/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payarc/payarc-sandbox/revisions/face82bdd778/schema)