What webhooks are available for plan and credit balance changes?
Last updated: March 12, 2025
Context
When managing customer subscriptions and credit balances, you may want to receive automated notifications when changes occur to either a customer's plan or their credit balance.
Answer
There are several webhook events available for tracking changes to customer plans and credit balances:
Plan Change Webhooks
The following webhooks are automatically available and require no additional setup:
Subscription Plan Changed - Triggered when a customer switches to a new plan
Subscription Plan Version Changed - Triggered when a customer moves to a new version of their current plan (e.g., v2 to v3)
Credit Balance Webhooks
Credit balance webhooks require setting up alerts for the specific customer first. Available webhooks include:
Credit Balance Depleted - Triggered when credits reach zero
Credit Balance Dropped - Triggered when credits fall below a configured threshold
Credit Balance Recovered - Triggered when credits are replenished after depletion
Note: Individual credit balance changes do not trigger webhook events unless they correspond to an configured alert threshold.