---
title: "Create Coupon"
method: POST
path: "/v1/shops/{shopId}/coupons"
tags: ["Coupons"]
---

# Create Coupon

`POST /v1/shops/{shopId}/coupons`

Creates a new coupon.

## Request body

- object
  - `code` string, required
  - `global` boolean, required
  - `discount` number, required — Must be at least -999999. Must not be greater than 999999.
  - `type` 'percentage' | 'fixed', required
  - `max_uses` number — Must be at least 1. Must not be greater than 999999.
  - `max_uses_per_customer` number — Must be at least 1. Must not be greater than 999999.
  - `min_invoice_price` number — Must be at least 0. Must not be greater than 999999.
  - `start_date` string — Must be a valid date. Must be a date before <code>2038-01-19</code>.
  - `expiration_date` string — Must be a valid date. Must be a date after <code>today</code>. Must be a date before <code>2038-01-19</code>.
  - `allowed_emails` string[] — Must be a valid email address.
  - `payment_method_ids` string[]
  - `disable_if_volume_discount` boolean
  - `disable_if_quantity_deal` boolean
  - `disable_if_bundle_offer` boolean
  - `disable_if_gateway_discount` boolean
  - `disable_if_affiliate_discount` boolean
  - `uses_count_mode` 'pending' | 'paid'
  - `applies_to_renewals` boolean
  - `items` string[] — This field is required when <code>global</code> is <code>false</code>.

## Response `200`

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) · [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sellauth/sellauth-api/revisions/945e6d749d68/schema)