---
title: "Delete a promotional code"
method: DELETE
path: "/promotional-codes"
---

# Delete a promotional code

`DELETE /promotional-codes`

Permanently deletes a promotional code. Any customer who tries to use it at checkout after this will be rejected. Sales already recorded against the code keep their history.

This cannot be undone — set `active` to `false` with [Update a Promotional Code](/api-reference/promotional-codes/update) if you only want to stop new redemptions. Fires the `promotional_code.deleted` webhook.

## Request body

- PromotionalCodeDelete
  - `promotionalCodeId` string, uuid, required — The promotional code ID to delete

## Response `200`

The promotional code was deleted.

- object
  - `message` string — Confirmation message
  - `deletedCode` object — The promotional code that was removed
    - `id` string, uuid — The deleted promotional code ID
    - `code` string — The deleted code string

## Other responses

- `400` — `promotionalCodeId` 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 promotional code with that ID exists in this program.
- `429` — Too many requests for this token on this endpoint. Please slow down.
- `500` — The promotional code 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)