Plan Change | Webhook Events - HoopAI Help Center

The PlanChange event fires whenever a user upgrades or downgrades the plan associated with your installed app. The payload includes both the previous plan ID and the new plan ID, giving you a complete picture of the transition. Use this event to adjust feature entitlements, update billing records in external systems, or trigger plan-specific onboarding or offboarding steps.

Payload

Field	Type	Description
`type`	`string`	Always `"PLAN_CHANGE"`
`appId`	`string`	ID of the app whose plan was changed
`locationId`	`string`	Account ID if the plan change occurred at the location level
`companyId`	`string`	Company ID associated with the account
`userId`	`string`	ID of the user who initiated the plan change
`currentPlanId`	`string`	ID of the plan the account was on before the change
`newPlanId`	`string`	ID of the plan the account has switched to

Example payload

{
  "type": "PLAN_CHANGE",
  "appId": "ve9EPM428h8vShlRW1KT",
  "locationId": "otg8dTQqGLh3Q6iQI55w",
  "companyId": "otg8dTQqGLh3Q6iQI55w",
  "userId": "otg8dTQqGLh3Q6iQI55w",
  "currentPlanId": "66a0419a0dffa47fb5f8b22f",
  "newPlanId": "77b1530b1egg58gc6g9c33g"
}

App Install — fires at initial installation and includes the starting plan
OAuth 2.0 — authorization and app management overview

​Payload

​Example payload

​Related

Payload

Example payload

Related