# App Installs

## Endpoints

### Create an app install

- [POST /v1/apps/installs](https://docs.stripe.com/api/apps/installs/create.md)

### Update an app install

- [POST /v1/apps/installs/:id](https://docs.stripe.com/api/apps/installs/update.md)

### Retrieve an app install

- [GET /v1/apps/installs/:id](https://docs.stripe.com/api/apps/installs/retrieve.md)

### List all app installs

- [GET /v1/apps/installs](https://docs.stripe.com/api/apps/installs/list.md)

### Uninstall an app install

- [POST /v1/apps/installs/:id/uninstall](https://docs.stripe.com/api/apps/installs/uninstall.md)

## Events

- `apps.install.created`
Occurs whenever a user installs a Stripe app. Sent to the app developer, embedding platform, and installing merchant.

- `apps.install.deleted`
Occurs whenever a user uninstalls a Stripe app. Sent to the app developer, embedding platform, and installing merchant.

- `apps.install.updated`
Occurs whenever a user updates a Stripe app. Sent to the app developer, embedding platform, and installing merchant.

An app install represents a Stripe App that is installed on an account. It reports the permissions, content security policy entries, and endpoints that the installing account has authorized, along with any that the app’s latest version requests but the account has not authorized yet. Use the Install API to install, reauthorize, and uninstall apps, and to check the state of existing installs.