subscription.version_change_canceled

{ "event": "subscription.version_change_canceled", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "toVersionId": "plnrel_v4", "reason": "addon_unavailable" } }

When this fires

A move to another version that was waiting for the subscription’s renewal will not happen, and the subscription stays on its version. toVersionId is the version it was going to move to, and reason says why:

`reason`	What happened
`canceled_by_merchant`	You canceled the move with Revoke scheduled version change, or canceled the plan move for every subscriber or for this one.
`addon_unavailable`	At renewal the subscription has an active add-on the destination version does not sell.
`seat_limit_exceeded`	At renewal the subscription has more seats than the destination version allows.
`price_not_found`	The destination version does not sell the price the subscription pays.
`missing_regional_price`	The destination version does not sell the subscription’s currency. A move never changes the currency.
`version_change_failed`	The move could not be applied at renewal.

A move made now has nothing pending, so it never fires this event. Neither does a new move that replaces the pending one, a change to another plan, or a subscription that ends instead of renewing: the pending move is dropped and scheduledVersionChange becomes null. To move the subscription later, resolve what reason names and request the move again.

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.

Body

application/json

string

required

event

string

required

Allowed value: "subscription.version_change_canceled"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

subscription.version_change_canceled

When this fires

Body

Response

​When this fires

Body

Response

When this fires