---
title: "Delete a coupon"
method: DELETE
path: "/coupons"
---

# Delete a coupon

`DELETE /coupons`

Permanently deletes a coupon **and every promotional code attached to it**. Any code your affiliates are already sharing stops working immediately. This cannot be undone — set `valid` to `false` with [Update a Coupon](/api-reference/coupons/update) if you only want to stop new redemptions.

Fires the `coupon.deleted` webhook.

## Request body

- CouponDelete
  - `couponId` string, uuid, required — The coupon to delete. Its promotional codes are deleted with it.

## Response `200`

The coupon and its promotional codes were deleted.

- object
  - `message` string — Confirmation message
  - `deletedCoupon` object — The coupon that was removed
    - `id` string, uuid — The deleted coupon ID
    - `name` string, nullable — The deleted coupon's name

## Other responses

- `400` — `couponId` was not supplied.
- `401` — The `Authorization` header is missing, is not a `Bearer` header, or the token is not valid.
- `403` — API access is not enabled for this account.
- `404` — No coupon with that ID exists in this program.
- `429` — Too many requests for this token on this endpoint. Please slow down.
- `500` — The coupon could not be deleted.

---

[API](https://skmtc.net/referly/apis/referly-api.md) · [All operations](https://skmtc.net/referly/apis/referly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/referly/referly-api/versions/0f506d61b9c3/schema)