Fires when a subscription ends completely (no longer billing). This is the final churn event for calculating churn rate.
JavaScript
window._upstack('track', 'subscription_churned', {
subscriptionId: 'sub_def456',
accountId: 'acct_abc123',
planId: 'plan_pro_monthly',
cancelReason: 'switched_competitor',
mrr: 9900,
ltv: 118800,
subscriptionMonths: 12
});
Properties
| Property | Type | Required | Description |
|---|
| subscriptionId | string | Yes | Subscription identifier |
| accountId | string | Yes | Account identifier |
| planId | string | No | Churned plan |
| cancelReason | string | No | Churn reason |
| mrr | number | No | Lost MRR in cents |
| ltv | number | No | Customer lifetime value in cents |
| subscriptionMonths | number | No | How long they were subscribed |
When to Fire
- When final billing period ends
- When subscription is deactivated
- When Stripe
customer.subscription.deleted fires
Stripe Webhook
Maps to customer.subscription.deleted.
Use this event to calculate churn rate and analyze churn reasons. Track ltv to understand which customer segments have the highest lifetime value.
