Fanvue API Documentation

Two events share the subscription resource. They are delivered in the Standard-Webhooks envelope; the fields below describe the data object. Every event requires the read:self scope.

Event (`type`)	Fires when
`app.subscription.activated`	A subscription becomes active
`app.subscription.cancel_at_period_end_changed`	Auto-renew is turned off; access continues until period end

Fanvue models cancellation as cancel_at_period_end plus an expires_at, not an immediate removal: a buyer who cancels keeps access until expires_at. Gate access on expires_at, not on status. The money and the access state are separate events: a subscription’s initial charge emits both app.payment.succeeded (with billing_reason: subscription_initial) and app.subscription.activated.

app.subscription.deactivated is reserved for when a subscription’s access actually ends, but is not emitted yet. Read live subscription state with the App Subscriptions endpoints in the meantime.

Subscription resource

data.object is "subscription" for both events.

Field	Type	Description
`object`	string	Always `"subscription"`
`id`	string	Subscription id
`status`	string	`active` \| `cancelled` \| `expired`
`cancel_at_period_end`	boolean	Whether the subscription will stop renewing at `expires_at`
`expires_at`	string \| null	ISO 8601 end of the current period
`created_at`	string \| null	ISO 8601 time the subscription started
`plan`	object	`{ uuid }` of the subscribed pricing plan (`uuid` may be `null`)
`provider_subscription_id`	string \| null	Upstream provider subscription id, if any
`app`	object	`{ uuid }` of your app
`buyer`	object	`{ uuid }` of the buyer
`metadata`	object	Reserved passthrough metadata map (currently always empty)

Examples

`app.subscription.activated`

{
  "id": "3d4e5f60718293a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f708",
  "type": "app.subscription.activated",
  "timestamp": "2026-06-17T13:12:45.200Z",
  "data": {
    "object": "subscription",
    "id": "3f9a2b71-1c4e-4f8a-9d2b-7c6e5a4b3d21",
    "status": "active",
    "cancel_at_period_end": false,
    "expires_at": "2026-07-17T13:12:45.000Z",
    "created_at": "2026-06-17T13:12:45.000Z",
    "plan": { "uuid": "b2d7c9f0-4a13-4e6b-8f25-1a9c3e7d5b80" },
    "provider_subscription_id": "psub_8a0f2d4b6c8e",
    "app": { "uuid": "a1c3e5f7-9b2d-4c6e-8a0f-2d4b6c8e0a13" },
    "buyer": { "uuid": "c4e6a8b0-2d4f-6a81-0c2e-4b6d8f0a2c46" },
    "metadata": {}
  }
}

`app.subscription.cancel_at_period_end_changed`

{
  "id": "4e5f60718293a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f70819",
  "type": "app.subscription.cancel_at_period_end_changed",
  "timestamp": "2026-06-20T09:00:00.000Z",
  "data": {
    "object": "subscription",
    "id": "3f9a2b71-1c4e-4f8a-9d2b-7c6e5a4b3d21",
    "status": "cancelled",
    "cancel_at_period_end": true,
    "expires_at": "2026-07-17T13:12:45.000Z",
    "created_at": "2026-06-17T13:12:45.000Z",
    "plan": { "uuid": "b2d7c9f0-4a13-4e6b-8f25-1a9c3e7d5b80" },
    "provider_subscription_id": "psub_8a0f2d4b6c8e",
    "app": { "uuid": "a1c3e5f7-9b2d-4c6e-8a0f-2d4b6c8e0a13" },
    "buyer": { "uuid": "c4e6a8b0-2d4f-6a81-0c2e-4b6d8f0a2c46" },
    "metadata": {}
  }
}

Reconciling

Because app.subscription.deactivated is not emitted yet, and because webhooks can be missed or delayed, read live subscription state from the App Subscriptions endpoints rather than deriving it from events alone.

Overview

Creator events

Checkout

App webhooks

Legacy events (deprecated)

App Subscription Events

Subscription resource

Examples

`app.subscription.activated`

`app.subscription.cancel_at_period_end_changed`

Reconciling

​Subscription resource

​Examples

​app.subscription.activated

​app.subscription.cancel_at_period_end_changed

​Reconciling

Subscription resource

Examples

`app.subscription.activated`

`app.subscription.cancel_at_period_end_changed`

Reconciling