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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API App Installations

> Une App Installation représente une installation de votre app sur un compte.

Un compte n'installe une app qu'une seule fois, quel que soit le nombre d'expériences qu'il ajoute ; une installation contient donc un état qui appartient au compte plutôt qu'à une expérience, comme un curseur de synchronisation ou l'ID du compte auquel il est lié dans un autre système.

Utilisez l'API App Installations pour [lister les comptes sur lesquels votre app est installée](https://docs.whop.com/fr/api-reference/app-installations/list-app-installations.md), [en récupérer un](https://docs.whop.com/fr/api-reference/app-installations/retrieve-app-installation.md) et [mettre à jour](https://docs.whop.com/fr/api-reference/app-installations/update-app-installation.md) les `metadata` et l'`external_id` que votre app y conserve. Un compte peut aussi lister les apps installées sur lui, et un développeur toutes les installations de son app. Seuls l'app et son développeur voient `metadata` et `external_id`, et seule l'app peut les modifier.

## Endpoints

| Endpoint | Requête |
| - | - |
| [List App Installations](https://docs.whop.com/fr/api-reference/app-installations/list-app-installations.md) | GET `/app_installations` |
| [Retrieve App Installation](https://docs.whop.com/fr/api-reference/app-installations/retrieve-app-installation.md) | GET `/app_installations/{id}` |
| [Update App Installation](https://docs.whop.com/fr/api-reference/app-installations/update-app-installation.md) | PATCH `/app_installations/{id}` |

## Attributs

**id** `string` *required*

ID de l'installation de l'app, préfixé par `aag_`.

**account** `object` *required*

Compte sur lequel l'app est installée.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

**app** `object` *required*

App installée.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID de l'app, préfixé par `app_`.
>
> **developer** `object` *required*
>
> Compte qui développe l'app.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID du compte, préfixé par `biz_`.
> >
> > **title** `string` *required*
> >
> > Nom d'affichage du compte.
>
> **icon** `object` *required*
>
> Icône de l'app. Utilise l'icône d'app par défaut lorsqu'aucune n'est téléversée.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'icône. Toujours présente : l'icône d'app par défaut lorsqu'aucune n'est téléversée.
>
> **name** `string` *required*
>
> Nom d'affichage de l'app.

**created\_at** `string` *required*

Date de la première installation de l'app sur le compte, sous forme d'horodatage ISO 8601. Une réinstallation ultérieure de l'app conserve la date d'origine.

**external\_id** `string | null` *required*

L'identifiant propre à votre app pour cette installation, comme l'ID du compte lié dans un autre système, ou `null` lorsqu'aucun n'est défini. 255 caractères au maximum et unique parmi les installations de votre app, afin que vous puissiez retrouver une installation avec `GET /app_installations?external_id=` ; définir un identifiant déjà utilisé par une autre installation renvoie une erreur `409`. Seuls l'app et son développeur le voient ; pour le compte sur lequel l'app est installée, il vaut toujours `null`.

**metadata** `object | null` *required*

Clés et valeurs de type chaîne que votre app stocke à propos de cette installation, comme un curseur de synchronisation ou l'ID du compte lié dans un autre système. Vide jusqu'à ce que votre app définisse une clé, et conservé si le compte supprime puis réinstalle l'app. 50 clés au maximum ; les clés font au plus 100 caractères et les valeurs au plus 500. Seule l'app peut le modifier. Seuls l'app et son développeur le voient ; pour le compte sur lequel l'app est installée, il vaut toujours `null`.

**requesting\_reauthorization** `boolean` *required*

Indique si l'app demande désormais des autorisations que le compte n'a pas encore approuvées.

**updated\_at** `string` *required*

Date de dernière modification de l'installation, par exemple une mise à jour de `metadata` ou une modification des autorisations de l'app par le compte, sous forme d'horodatage ISO 8601.

```json AppInstallation theme={null}
{
	"id": "aag_T4k8M2p6W9r3Qx",
	"app": {
		"id": "app_Q7m3V9k2X5t8Lp",
		"name": "QuickBooks Sync",
		"icon": {
			"url": "https://assets.whop.com/apps/quickbooks-sync/icon.png"
		},
		"developer": {
			"id": "biz_W3r7N1k5P8q2Hd",
			"title": "Ledgerline Labs"
		}
	},
	"account": {
		"id": "biz_J8n2R5p9T1w4Kx",
		"title": "Acme Bookkeeping"
	},
	"external_id": "acme-store",
	"metadata": {
		"last_synced_at": "2026-10-16T21:00:00Z",
		"quickbooks_realm_id": "9341452712"
	},
	"requesting_reauthorization": false,
	"created_at": "2026-09-02T15:30:00.000Z",
	"updated_at": "2026-10-16T21:00:04.000Z"
}
```


## Related topics

- [List App Installations](https://docs.whop.com/fr/api-reference/app-installations/list-app-installations.md)
- [App installation deleted](https://docs.whop.com/fr/api-reference/app-installations/app-installation-deleted.md)
- [App installation created](https://docs.whop.com/fr/api-reference/app-installations/app-installation-created.md)
