---
title: "Delete referrals"
method: DELETE
path: "/referrals"
---

# Delete referrals

`DELETE /referrals`

Permanently deletes a referral and the sales that cascade from it. This cannot be undone.

`referralId` accepts either the referral's UUID or the referred user's email address. The request succeeds with the same response even when nothing matched. Fires the `referral.deleted` webhook.

## Request body

- ReferralDelete
  - `referralId` string, required — The referral to delete. Accepts the referral's UUID or the referred user's email address.

## Response `200`

The referral was deleted.

- DeleteMessage
  - `message` string — Confirmation message

## Other responses

- `400` — `referralId` was not supplied, or the delete failed.
- `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` — The affiliate program this token belongs to no longer exists.
- `429` — Too many requests for this token on this endpoint. Please slow down.

---

[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/revisions/0f506d61b9c3/schema)