---
title: "POST /forms/{slug_or_id}/coupons"
method: POST
path: "/forms/{slug_or_id}/coupons"
tags: ["Coupons"]
---

# POST /forms/{slug_or_id}/coupons

`POST /forms/{slug_or_id}/coupons`

This endpoint creates a specific coupon on a form.
This feature is available as part of the [Standard API](https://paperform.co/pricing/).

## Path parameters

- `slug_or_id` string, required

## Request body

- CouponWithCode
  - `code` string — The coupon code.
  - `enabled` boolean — Whether the coupon is enabled or not.
  - `target` 'price' | 'subscription' — The target of the coupon.
  - `discountAmount` number — The discount as an amount.
  - `discountPercentage` number — The discount as a percentage.
  - `expiresAt` string, date-time, nullable — The date and time when the coupon expires.

## Response `200`

Successfully created a single coupon with the provided values

- object
  - `status` 'ok'
  - `results` object
    - `coupon` CouponWithCode
      - `code` string — The coupon code.
      - `enabled` boolean — Whether the coupon is enabled or not.
      - `target` 'price' | 'subscription' — The target of the coupon.
      - `discountAmount` number — The discount as an amount.
      - `discountPercentage` number — The discount as a percentage.
      - `expiresAt` string, date-time, nullable — The date and time when the coupon expires.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `403` — Not Permitted
- `404` — Not Found
- `422` — Validation Error
- `429` — Too Many Requests
- `5XX` — Unexpected Error

---

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