> ## 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.version_changed

> Fired when a subscription moves to another version of its plan, now or at its renewal.

## When this fires

A subscription moves to another version of the same plan:

* right away, after [Change subscription version](https://commet.co/docs/api-reference/subscriptions/change-subscription-version.md) or a plan move made now;
* at its renewal, when a move scheduled for the end of the period takes effect.

From this event the subscription has the destination version's features, limits and included credits or balance. A move made now charges the new version's price from the next renewal; a move never creates a proration charge or refund.

`currency` is the subscription's currency, which a move never changes. `billingInterval` is the interval it pays after the move.

| Moment | Event | What to do |
| - | - | - |
| Move scheduled for renewal | None. The subscription shows it in `scheduledVersionChange`. | Show the upcoming change if your UI lists plan terms. |
| Move takes effect | `subscription.version_changed` | Refresh the features and limits you keep for the subscription. |
| Scheduled move no longer happens | `subscription.version_change_canceled` | Remove the upcoming change. |

A trialing subscription with a pending move moves when its trial ends, so its first charge is already on the destination version. A subscription that ends or changes to another plan instead of renewing on its plan never moves and sends neither event.

Only endpoints that list this event receive it. New event types are not added to existing endpoints: add it to the endpoint's events in **Settings → Webhooks** or with [Update webhook endpoint](https://commet.co/docs/api-reference/webhooks/update-webhook-endpoint.md).


## OpenAPI

````yaml /openapi/en/webhooks/2026-08-27.json webhook subscription.version_changed
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.