Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.envless.cloud/llms.txt

Use this file to discover all available pages before exploring further.

When it fires

After UpdateSubscription writes changes. Typically triggered by the Polar subscription.updated webhook handler. actor is always null.

Payload

{
    type: 'subscription.updated',
    data: {
        subscription: {
            id: string
            status: string
            polarSubscriptionId: string
            polarProductId: string
            currentPeriodStart: string | null
            currentPeriodEnd: string | null
            canceledAt: string | null
        }
        changes: Array<'status' | 'currentPeriodStart' | 'currentPeriodEnd' | 'canceledAt'>
    }
}

Example — cancellation

{
    "type": "subscription.updated",
    "actor": null,
    "data": {
        "subscription": {
            "id": "0192a1b2-c3d4-7000-8000-0000000000c0",
            "status": "canceled",
            "polarSubscriptionId": "sub_abc123",
            "polarProductId": "prod_xyz789",
            "currentPeriodStart": "2026-05-31T00:00:00.000Z",
            "currentPeriodEnd": "2026-06-30T23:59:59.999Z",
            "canceledAt": "2026-06-10T15:00:00.000Z"
        },
        "changes": ["status", "canceledAt"]
    }
}