> ## 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 de App Installations

> Una App Installation representa una instalación de tu app en una cuenta.

Una cuenta instala una app una sola vez, sin importar cuántas experiencias añada, por lo que una instalación guarda el estado que pertenece a la cuenta y no a una experiencia concreta, como un cursor de sincronización o el ID de la cuenta con la que está vinculada en otro sistema.

Usa la API de App Installations para [listar las cuentas en las que está instalada tu app](https://docs.whop.com/es/api-reference/app-installations/list-app-installations.md), [obtener una](https://docs.whop.com/es/api-reference/app-installations/retrieve-app-installation.md) y [actualizar](https://docs.whop.com/es/api-reference/app-installations/update-app-installation.md) los campos `metadata` y `external_id` que tu app guarda en ella. Una cuenta también puede listar las apps instaladas en ella, y un desarrollador todas las instalaciones de su app. Solo la app y su desarrollador ven `metadata` y `external_id`, y solo la app puede cambiarlos.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar App Installations](https://docs.whop.com/es/api-reference/app-installations/list-app-installations.md) | GET `/app_installations` |
| [Obtener App Installation](https://docs.whop.com/es/api-reference/app-installations/retrieve-app-installation.md) | GET `/app_installations/{id}` |
| [Actualizar App Installation](https://docs.whop.com/es/api-reference/app-installations/update-app-installation.md) | PATCH `/app_installations/{id}` |

## Atributos

**id** `string` *required*

ID de la instalación de la app, con el prefijo `aag_`.

**account** `object` *required*

Cuenta en la que está instalada la app.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

**app** `object` *required*

App que está instalada.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la app, con el prefijo `app_`.
>
> **developer** `object` *required*
>
> Cuenta que desarrolla la app.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID de la cuenta, con el prefijo `biz_`.
> >
> > **title** `string` *required*
> >
> > Nombre visible de la cuenta.
>
> **icon** `object` *required*
>
> Icono de la app. Usa el icono predeterminado de la app cuando no se ha subido ninguno.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del icono. Siempre presente: es el icono predeterminado de la app cuando no se ha subido ninguno.
>
> **name** `string` *required*
>
> Nombre visible de la app.

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

Cuándo se instaló la app por primera vez en la cuenta, como marca de tiempo
ISO 8601. Volver a instalar la app más tarde conserva la hora original.

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

El identificador propio de tu app para esta instalación, como el ID de la cuenta
vinculada en otro sistema, o `null` cuando no se ha establecido ninguno. Como
máximo 255 caracteres y único entre las instalaciones de tu app, para que puedas
encontrar una instalación con `GET /app_installations?external_id=`; establecer
uno que ya tiene otra instalación devuelve un `409`. Solo la app y su
desarrollador lo ven; para la cuenta en la que está instalada la app siempre es
`null`.

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

Claves y valores de tipo string que tu app almacena sobre esta instalación, como
un cursor de sincronización o el ID de la cuenta vinculada en otro sistema. Vacío
hasta que tu app establece una clave, y se conserva si la cuenta elimina la app y
la vuelve a instalar. Como máximo 50 claves; las claves tienen como máximo 100
caracteres y los valores como máximo 500. Solo la app puede cambiarlo. Solo la
app y su desarrollador lo ven; para la cuenta en la que está instalada la app
siempre es `null`.

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

Si la app ahora solicita permisos que la cuenta aún no ha aprobado.

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

Cuándo cambió la instalación por última vez, como una actualización de
`metadata` o un cambio de los permisos de la app por parte de la cuenta, como
marca de tiempo 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

- [API de Apps](https://docs.whop.com/es/api-reference/apps/app.md)
- [API de App Builds](https://docs.whop.com/es/api-reference/app-builds/app-build.md)
- [Autenticación y claves de API](https://docs.whop.com/es/developer/guides/auth-scoping.md)
