> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

---
id: a9a13417-be6e-4172-a53c-03b95dc8f859
---

# App uninstalls API

> Learn how to use the app uninstalls API to programmatically uninstall an app from a HubSpot account.

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](/docs/api-reference/latest/authentication/manage-oauth-tokens) 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.

```shell wrap theme={null}
curl https://api.hubapi.com/appinstalls/2026-03/external-install \
  --request DELETE \
  --header "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

A successful request returns a `204` response with no body. The account's admins will receive an email notification that the app has been uninstalled.