Skip to main content
subscription.cancelled is deprecated. Use creator.subscription.cancel_at_period_end_changed instead. This event continues to fire during the migration window; new integrations should use the creator.* event.

​
When this fires

Triggered (subscription.cancelled) when an active subscription is cancelled — the subscriber turns off auto-renew, the creator blocks them, or moderation ends the relationship. The subscriber usually keeps access until the end of the period they already paid for; accessEndsAt tells you when that access stops. Use this to react to churn the moment it is decided, instead of diffing subscriber snapshots on a schedule.
Cancellation and expiry are distinct events. subscription.cancelled fires when a cancellation is scheduled (access typically continues until accessEndsAt). subscription.expired fires when access actually ends. A typical lifecycle emits subscription.cancelled first, then subscription.expired when the paid period runs out.Requires the read:creator scope.

​
Payload

  • recipientUuid: UUID of the creator who was subscribed to
  • subscriberUuid: UUID of the fan whose subscription was cancelled
  • cancelReason: Why it was cancelled. One of subscriber_requested, creator_blocked, moderation.
  • cancelledAt: ISO 8601 time the cancellation was recorded
  • accessEndsAt: ISO 8601 end of the already-paid period; access continues until then. Equals cancelledAt when access ends immediately (for example, free-trial cancellations). May be null if no paid period applies.
  • 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",
  "cancelReason": "subscriber_requested",
  "cancelledAt": "2026-05-20T08:39:33.139Z",
  "accessEndsAt": "2026-06-19T08:39:33.139Z",
  "clientReferenceId": "crm-contact-8821",
  "metadata": {
    "campaign": "spring-promo"
  },
  "timestamp": "2026-05-20T08:39:33.310Z"
}