The app uninstalls API allows you to programmatically uninstall your app from a customer’s HubSpot account. This is useful for cleanup when a customer has stopped using your platform but the integration remains installed in their HubSpot account. Removing stale installs reduces unnecessary API traffic and keeps your app state accurate across systems.
Authentication
Requests to this endpoint are authenticated with an OAuth access token that includes the oauth scope. The app is uninstalled from the account associated with the access token you provide.
Uninstall an app
To uninstall an app, make a DELETE request to /appinstalls/2026-03/external-install with the account’s OAuth access token in the Authorization header.
curl https://api.hubapi.com/appinstalls/2026-03/external-install \
--request DELETE \
--header "Authorization: Bearer YOUR_ACCESS_TOKEN"
204 response with no body. The account’s admins will receive an email notification that the app has been uninstalled. Last modified on June 11, 2026
