---
title: "Subscription Changed"
method: POST
path: "SUBSCRIPTION_CHANGED"
tags: ["Membership Events"]
---

# Subscription Changed

`POST SUBSCRIPTION_CHANGED` (webhook)

Fired when a membership subscription is changed (e.g., tier change).

## Payload

- object
  - `id` string, required — Unique identifier for this webhook event
  - `webhookId` string, required — ID of the webhook configuration that triggered this event
  - `shopId` string, required — ID of the shop that generated this event
  - `type` string, required — The event type
  - `apiVersion` string, required — API version of the webhook payload
  - `createdAt` string, date-time, required — When this event was created
  - `testMode` boolean, required — Whether this event was sent in test mode
  - `data` ComFourthwallOpenapiModelMembershipSupporterV1, required
    - `id` string, required
    - `email` string, required
    - `nickname` string, required
    - `createdAt` string, date-time, required
    - `subscription` union, required
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionActive
        - `type` 'ACTIVE', required
        - `variant` ComFourthwallOpenapiModelMembershipTierVariantV1, required
          - `id` string, required
          - `tierId` string, required
          - `interval` 'ANNUAL' | 'MONTHLY', required
          - `amount` Money, required
            - `value` number, required
            - `currency` string, required
          - `offerId` string
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionCancelled
        - `type` 'CANCELLED', required
        - `variant` ComFourthwallOpenapiModelMembershipTierVariantV1, required
          - `id` string, required
          - `tierId` string, required
          - `interval` 'ANNUAL' | 'MONTHLY', required
          - `amount` Money, required
            - `value` number, required
            - `currency` string, required
          - `offerId` string
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionNone
        - `type` 'NONE', required
      - ComFourthwallOpenapiModelMembershipSupporterV1SubscriptionSuspended
        - `type` 'SUSPENDED', required
        - `variant` ComFourthwallOpenapiModelMembershipTierVariantV1, required
          - `id` string, required
          - `tierId` string, required
          - `interval` 'ANNUAL' | 'MONTHLY', required
          - `amount` Money, required
            - `value` number, required
            - `currency` string, required
          - `offerId` string

## Acknowledgement `200`

Event received successfully

---

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