Skip to main content
The AppUninstall event fires whenever your app is removed, either at the location (sub-account) level or at the agency level. The payload identifies the app and the account from which it was removed. Use this event to revoke stored tokens, clean up account-specific data, or trigger offboarding workflows.

Payload

FieldTypeDescription
typestringAlways "UNINSTALL"
appIdstringID of the app that was uninstalled
companyIdstringAgency ID from which the app was removed
locationIdstringSub-account ID if uninstalled at the location level; omitted for agency-level uninstalls

Example payload

Location level

{
  "type": "UNINSTALL",
  "appId": "ve9EPM428h8vShlRW1KT",
  "locationId": "otg8dTQqGLh3Q6iQI55w",
  "companyId": "otg8dTQqGLh3Q6iQI55w"
}

Agency level

{
  "type": "UNINSTALL",
  "appId": "ve9EPM428h8vShlRW1KT",
  "companyId": "otg8dTQqGLh3Q6iQI55w"
}
  • App Install — fires when your app is installed
  • OAuth 2.0 — authorization flow used during app installation
Last modified on March 4, 2026