Keeping track of updated entitlements at subscription level

Problem Statement

This article explains how to keep an up-to-date list of entitlements for subscriptions. Subscription changed events do not include entitlements data, and there is no webhook that fires when an entitlement is added or modified for a subscription.

Solution

Chargebee does not include entitlements in the subscription object to avoid bloat and scaling issues. To keep track of updated entitlements at the subscription level, call the List Subscription Entitlements API when you receive the entitlement_overrides_updated webhook, and use the response to refresh your list.

The endpoint is documented here. The entitlement_overrides_updated webhook indicates when an entitlement has been updated at the subscription level.