Source: https://www.revvly.ai/docs/concepts/lifecycleEvent

Billing & analytics

# Lifecycle Event

An immutable record of every revenue-moving moment.

## Overview

Every time something revenue-moving happens — a subscription is created, renewed, expanded, contracted, cancelled, or churned — Revvly writes a Lifecycle Event. These events are the source of truth for MRR, ARR, NRR, and churn analytics; subscription status alone is not used for those metrics. They're append-only: corrections go in as new events, never as overwrites. Each event stamps both the native-currency delta and the reporting-currency delta, so FX shifts don't rewrite history.

## How it connects

This concept highlighted in context. Click a peer to navigate.

Related

Client

Subscription

Lifecycle Event

Related

Contract

- One Subscription, one Client
- Never updated or deleted — corrections go in as new events
- Powers all MRR / ARR / NRR / churn analytics

## Key fields

What you’ll see when creating or editing a Lifecycle Event.

- **Type**: Created / Renewed / Reactivated / Expanded / Contracted / Cancel-scheduled / Churned

- **MRR delta (reporting)**: Signed, in your reporting currency

- **Native MRR + currency**: Preserved for historical re-conversion

- **Churn reason**: Required when type = Churned

- **Occurred at**: The economically real moment

- **Created at**: When it was written to the log

## Example

EXPANDED · Acme · +$25 MRR

Occurred

Apr 23, 2026

Native

+$25 USD

Reporting

+$25 USD