> ## 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.

# App Installations API

> Een App Installation vertegenwoordigt één installatie van je app op één account.

Een account installeert een app één keer, ongeacht hoeveel experiences het toevoegt, dus een installatie bevat status die bij het account hoort en niet bij één experience, zoals een sync-cursor of de ID van het account waaraan het in een ander systeem is gekoppeld.

Gebruik de App Installations API om [de accounts op te vragen waarop je app is geïnstalleerd](https://docs.whop.com/nl/api-reference/app-installations/list-app-installations.md), [er één op te halen](https://docs.whop.com/nl/api-reference/app-installations/retrieve-app-installation.md) en de `metadata` en `external_id` die je app erop bijhoudt [bij te werken](https://docs.whop.com/nl/api-reference/app-installations/update-app-installation.md). Een account kan ook de apps opvragen die erop zijn geïnstalleerd, en een developer elke installatie van zijn app. Alleen de app en de developer zien `metadata` en `external_id`, en alleen de app kan ze wijzigen.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [App Installations opvragen](https://docs.whop.com/nl/api-reference/app-installations/list-app-installations.md) | GET `/app_installations` |
| [App Installation ophalen](https://docs.whop.com/nl/api-reference/app-installations/retrieve-app-installation.md) | GET `/app_installations/{id}` |
| [App Installation bijwerken](https://docs.whop.com/nl/api-reference/app-installations/update-app-installation.md) | PATCH `/app_installations/{id}` |

## Attributen

**id** `string` *required*

App-installatie-ID, met prefix `aag_`.

**account** `object` *required*

Account waarop de app is geïnstalleerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

**app** `object` *required*

App die is geïnstalleerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> App-ID, met prefix `app_`.
>
> **developer** `object` *required*
>
> Account dat de app ontwikkelt.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Account-ID, met prefix `biz_`.
> >
> > **title** `string` *required*
> >
> > Weergavenaam van het account.
>
> **icon** `object` *required*
>
> App-icoon. Valt terug op het standaard app-icoon wanneer er geen is geüpload.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de icoonafbeelding. Altijd aanwezig — het standaard app-icoon wanneer er geen is geüpload.
>
> **name** `string` *required*
>
> Weergavenaam van de app.

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

Wanneer de app voor het eerst op het account is geïnstalleerd, als ISO 8601-tijdstempel. Als de app later opnieuw wordt geïnstalleerd, blijft het oorspronkelijke tijdstip behouden.

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

De eigen identificatie van je app voor deze installatie, zoals de ID van het gekoppelde account in een ander systeem, of `null` wanneer er geen is ingesteld. Maximaal 255 tekens en uniek binnen de installaties van je app, zodat je een installatie kunt vinden met `GET /app_installations?external_id=`; een waarde instellen die een andere installatie al heeft, retourneert een `409`. Alleen de app en de developer zien deze; voor het account waarop de app is geïnstalleerd is deze altijd `null`.

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

String-sleutels en -waarden die je app over deze installatie opslaat, zoals een sync-cursor of de ID van het gekoppelde account in een ander systeem. Leeg totdat je app een sleutel instelt, en behouden als het account de app verwijdert en opnieuw installeert. Maximaal 50 sleutels; sleutels zijn maximaal 100 tekens en waarden maximaal 500. Alleen de app kan dit wijzigen. Alleen de app en de developer zien dit; voor het account waarop de app is geïnstalleerd is dit altijd `null`.

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

Of de app nu om machtigingen vraagt die het account nog niet heeft goedgekeurd.

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

Wanneer de installatie voor het laatst is gewijzigd, zoals een `metadata`-update of een wijziging van de app-machtigingen door het account, als ISO 8601-tijdstempel.

```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/nl/api-reference/app-installations/list-app-installations.md)
- [App installation deleted](https://docs.whop.com/nl/api-reference/app-installations/app-installation-deleted.md)
- [App installation created](https://docs.whop.com/nl/api-reference/app-installations/app-installation-created.md)
