Fanvue API Documentation

subscription.expired is the deprecated flat event for a subscription ending and the subscriber losing access. It requires the read:creator scope, and new integrations use creator.subscription.deactivated instead.

Don’t build new integrations on subscription.expired. It keeps firing during the migration window, after which only creator.subscription.deactivated is delivered. Subscribe to creator.subscription.deactivated and move existing consumers before the window closes.

When this fires

subscription.expired fires when a subscription ends and the subscriber loses access, because the paid period ran out without renewing, a renewal payment failed, or one of the accounts was deleted or banned. subscription.expired is the terminal event in the subscription lifecycle. Where subscription.cancelled tells you a cancellation was scheduled, subscription.expired tells you access has been removed. An expiry is not always preceded by a cancellation, because a failed renewal expires a subscription with no prior subscription.cancelled.

Payload

Field	Description
`recipientUuid`	UUID of the creator who was subscribed to
`subscriberUuid`	UUID of the fan whose subscription expired
`reason`	Why it ended. One of `payment_failed`, `not_renewed`, `user_deleted`, `user_banned`, `other`.
`expiredAt`	ISO 8601 time access was removed
`clientReferenceId`	The attribution reference captured on the original subscription purchase, echoed here so churn events carry the same attribution as the `subscription.new` event. Omitted when the subscription was not attributed. See Checkout attribution.
`metadata`	The custom metadata captured on the original subscription purchase, echoed here. Omitted when none was set.
`timestamp`	ISO 8601 time the event was emitted

Example payload

{
  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
  "subscriberUuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
  "reason": "payment_failed",
  "expiredAt": "2026-06-19T08:39:33.139Z",
  "clientReferenceId": "crm-contact-8821",
  "metadata": {
    "campaign": "spring-promo"
  },
  "timestamp": "2026-06-19T08:39:33.310Z"
}

Receiving events

Creator events

Checkout link events

App events

Legacy events (deprecated)

Subscription Expired Webhook (deprecated)

When this fires

Payload

Example payload

​When this fires

​Payload

​Example payload

When this fires

Payload

Example payload