---
title: "Create subscription coupon"
method: POST
path: "/v1/admin/coupons"
tags: ["Operations"]
---

# Create subscription coupon

`POST /v1/admin/coupons`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/admin/coupons`
- Auth: HTTP bearer

Create subscription coupon. The response is scoped and validated by the runtime repository; unknown or unauthorized resources use the canonical error envelope.

## Request body

- object
  - `code` string, required
  - `discount_type` 'percent' | 'fixed', required
  - `percent_off` number
  - `amount_off_cents` number
  - `duration` 'once' | 'repeating' | 'forever'
  - `duration_in_months` integer, nullable
  - `applies_to_tier` string, nullable
  - `applies_to_period` 'all' | 'monthly' | 'annual'
  - `max_redemptions` integer, nullable
  - `per_customer_limit` number
  - `starts_at` string, nullable
  - `expires_at` string, nullable
  - `note` string

## Response `200`

Create subscription coupon response

- object: Created coupon. Discounts affect price only.

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `413`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)