---
title: "subscription.revoked"
method: POST
path: "subscription.revoked"
---

# subscription.revoked

`POST subscription.revoked` (webhook)

Sent when a subscription is revoked and the user loses access immediately.
Happens when the subscription is canceled or payment retries are exhausted (status becomes `unpaid`).

For payment failures that can still be recovered, see `subscription.past_due`.

**Discord & Slack support:** Full

## Payload

- WebhookSubscriptionRevokedPayload — Sent when a subscription is revoked and the user loses access immediately. Happens when the subscription is canceled or payment retries are exhausted (status becomes `unpaid`). For payment failures that can still be recovered, see `subscription.past_due`. **Discord & Slack support:** Full
  - `type` 'subscription.revoked', required
  - `timestamp` string, date-time, required
  - `data` Subscription, required — unresolved $ref

## Acknowledgement `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/77e4ef94fcc3/schema)