> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# subscription.cancellation_scheduled

> Fired when a cancellation is scheduled for the end of the billing period. Do NOT revoke access yet.

## Cancellation lifecycle

This event marks the start of the cancellation lifecycle. The subscription stays fully usable until `effectiveAt`:

| Moment | Event | status | What to do |
| - | - | - | - |
| Customer requests cancellation | `subscription.cancellation_scheduled` | `active` | Show "ending on \{effectiveAt}" in your UI. Do NOT revoke access. |
| Customer reverts the cancellation | `subscription.cancellation_revoked` | `active` | Remove the "ending on" notice. |
| Billing period ends | `subscription.canceled` | `canceled` | Revoke access. |

`subscription.updated` also fires at the scheduling moment for backward compatibility — if you already handle the scheduled-cancel state through `subscription.updated`, you can keep doing so. This event carries the same intent with an explicit name and the exact `effectiveAt`.


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook subscription.cancellation_scheduled
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.