What is it?

You can now use a public API endpoint that allows you to programmatically uninstall customers from your app. This API is now Generally Available (GA).

When you send a successful request to this endpoint, you’ll receive a 204 No Content HTTP response. Once the uninstall is complete, HubSpot will automatically send an email notification to the customer’s account admins, letting them know that the app has been removed from their portal.

The API requires the customer’s existing OAuth Access Token to authenticate the request. You can learn more about managing and using OAuth in our developer documentation.

The email notification sent to account admins also includes a link to the app’s connection page. This allows them to reinstall the app if the uninstall was unintentional or if they decide to reconnect the integration later.

Why does it matter?

Many app partners have customers who no longer use their product but still have the integration installed in HubSpot. This can result in unnecessary API calls between systems, creating inefficiencies and extra load.

With this new API endpoint, you can now proactively remove inactive or unused installs directly from your systems. This helps you maintain cleaner integration data, reduce unnecessary API traffic, and ensure your app usage more accurately reflects active customer relationships.

How does it work?

The new endpoint uses the DELETE method. Full documentation is available in the App Uninstall API endpoint reference.

Example curl request:

curl --location --request DELETE 'https://api.hubspot.com/appinstalls/v3/external-install' \

--header 'Authorization: Bearer :access token:'

Who gets it?

This API is available to all hubs and tiers.