Skip to main content
Three events share the subscription resource. They are delivered in the Standard-Webhooks envelope; the fields below describe the data object.
Event (type)Fires when
checkout_link.subscription.activatedA subscription becomes active via a checkout link
checkout_link.subscription.deactivatedA subscription ends (expired or otherwise deactivated)
checkout_link.subscription.cancel_at_period_end_changedAuto-renew is turned off or back on
A subscription is a fan’s active, recurring access to a product sold through a checkout link. Fanvue models cancellation as cancel_at_period_end plus an expires_at, not an immediate removal: a fan who cancels keeps access until expires_at, and the deactivated event fires when access actually ends.

​
Subscription resource

FieldTypeDescription
objectstringAlways "subscription"
idstringSubscription uuid
statusstringactive | cancelled | expired
cancel_at_period_endbooleanWhether the subscription will stop renewing at expires_at
expires_atstring | nullISO 8601 end of the current period
created_atstring | nullISO 8601 time the subscription started
client_reference_idstring | nullYour passthrough reference (see Attribution)
deactivation_reasonstring | nullWhy the subscription ended (e.g. NON_RENEWING); null while active
checkout_linkobject{ uuid, name, product_uuid, product_price_uuid }
purchaserobject{ uuid, email } of the subscriber (email may be null)
creatorobject{ uuid } of the creator
metadataobjectYour passthrough metadata map

​
Examples

{
  "id": "f1a2b3c4-4444-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "checkout_link.subscription.activated",
  "timestamp": "2026-06-09T08:00:00.000Z",
  "data": {
    "object": "subscription",
    "id": "sub-uuid",
    "status": "active",
    "cancel_at_period_end": false,
    "expires_at": "2026-07-09T08:00:00.000Z",
    "created_at": "2026-06-09T08:00:00.000Z",
    "client_reference_id": "your-crm-id-123",
    "deactivation_reason": null,
    "checkout_link": {
      "uuid": "ck-uuid",
      "name": "VIP Monthly",
      "product_uuid": "prod-uuid",
      "product_price_uuid": "pp-uuid"
    },
    "purchaser": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": { "affiliate_id": "aff_123", "campaign": "spring" }
  }
}

{
  "id": "f1a2b3c4-6666-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "checkout_link.subscription.cancel_at_period_end_changed",
  "timestamp": "2026-06-20T08:00:00.000Z",
  "data": {
    "object": "subscription",
    "id": "sub-uuid",
    "status": "cancelled",
    "cancel_at_period_end": true,
    "expires_at": "2026-07-09T08:00:00.000Z",
    "created_at": "2026-06-09T08:00:00.000Z",
    "client_reference_id": "your-crm-id-123",
    "deactivation_reason": null,
    "checkout_link": {
      "uuid": "ck-uuid",
      "name": "VIP Monthly",
      "product_uuid": "prod-uuid",
      "product_price_uuid": "pp-uuid"
    },
    "purchaser": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": { "affiliate_id": "aff_123", "campaign": "spring" }
  }
}

{
  "id": "f1a2b3c4-5555-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "checkout_link.subscription.deactivated",
  "timestamp": "2026-07-09T08:00:00.000Z",
  "data": {
    "object": "subscription",
    "id": "sub-uuid",
    "status": "expired",
    "cancel_at_period_end": false,
    "expires_at": "2026-07-09T08:00:00.000Z",
    "created_at": "2026-06-09T08:00:00.000Z",
    "client_reference_id": "your-crm-id-123",
    "deactivation_reason": "NON_RENEWING",
    "checkout_link": {
      "uuid": "ck-uuid",
      "name": "VIP Monthly",
      "product_uuid": "prod-uuid",
      "product_price_uuid": "pp-uuid"
    },
    "purchaser": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": { "affiliate_id": "aff_123", "campaign": "spring" }
  }
}