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

> Una app es una integración construida sobre Whop. Las apps pueden servir a los consumidores como experiencias dentro de los productos o servir a las empresas como herramientas de negocio.

> [!NOTE]
>
> Este recurso tiene un sucesor en la [API actual](https://docs.whop.com/es/api-reference/legacy/apps/app.md), la API versionada sobre la que deben construirse las nuevas integraciones. Esta página sigue teniendo soporte completo.

```json Example theme={null}
{
	"api_key": {
		"created_at": "2023-12-01T05:00:00.401Z",
		"id": "<string>",
		"token": "<string>"
	},
	"app_type": "b2b_app",
	"base_url": "https://myapp.example.com",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe"
	},
	"creator": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	},
	"dashboard_path": "/experiences/[experienceId]",
	"default_api_key": {
		"id": "<string>",
		"name": "<string>",
		"obfuscated_secret_key": "<string>",
		"secret_key": "<string>"
	},
	"description": "A comprehensive analytics dashboard for tracking revenue, members, and growth metrics.",
	"discover_path": "/experiences/[experienceId]",
	"domain_id": "ab1c2d3e4f5g6h7i8j9k",
	"experience_path": "/experiences/[experienceId]",
	"hosted_url": "https://myapp.whop.site",
	"icon": {
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"id": "app_xxxxxxxxxxxxxx",
	"marketplace_status": "not_available",
	"name": "Courses",
	"oauth_client_type": "public",
	"openapi_path": "/experiences/[experienceId]",
	"origin": "<string>",
	"product_id": "<string>",
	"production_web_build": {
		"checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
		"file_url": "https://cdn.whop.com/builds/abc123.zip",
		"id": "apbu_xxxxxxxxxxxxx",
		"source_url": "https://cdn.whop.com/builds/abc123-source.zip",
		"status": "draft"
	},
	"redirect_uris": ["<string>"],
	"requested_permissions": [
		{
			"is_required": true,
			"justification": "<string>",
			"permission_action": {
				"action": "<string>",
				"name": "<string>"
			}
		}
	],
	"route": "myapp",
	"secrets": {},
	"skills_path": "/experiences/[experienceId]",
	"stats": {
		"dau": 42,
		"mau": 42,
		"time_spent_last24_hours": 42,
		"wau": 42
	},
	"status": "live",
	"verified": true
}
```

**api\_key** `object | null` *required*

La clave de API usada para autenticar solicitudes en nombre de esta app. Null si no se ha generado ninguna clave de API. Requiere el permiso 'developer:manage\_api\_key'.

**atributos secundarios**

**created\_at** `string\<date-time\>` *required*

La fecha y hora en que se creó la clave de API privada.

Ejemplo: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

El identificador único de la clave de API privada.

**token** `string` *required*

Esta es la clave de API usada para autenticar solicitudes

**app\_type** `AppTypes` *required*

La clasificación del público objetivo de esta app (p. ej., 'b2b\_app', 'b2c\_app', 'company\_app', 'component').

Opciones disponibles: `b2b_app`, `b2c_app`, `company_app`, `component`, `website`

**base\_url** `string | null` *required*

La URL base de producción donde se aloja la app. `null` si no hay ninguna URL base configurada o si el llamante no tiene el permiso `developer:basic:read` en la cuenta de la app.

Ejemplo: `https://myapp.example.com`

**company** `object` *required*

La empresa propietaria que publica esta app.

**atributos secundarios**

**id** `string` *required*

El identificador único de la empresa.

Ejemplo: `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

El nombre visible de la empresa que se muestra a los clientes.

Ejemplo: `Pickaxe`

**creator** `object` *required*

El usuario que creó y es propietario de la empresa que publicó esta app.

**atributos secundarios**

**id** `string` *required*

El identificador único del usuario.

Ejemplo: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

El nombre visible del usuario que se muestra en su perfil público.

Ejemplo: `John Doe`

**username** `string` *required*

El nombre de usuario único del usuario que se muestra en su perfil público.

Ejemplo: `johndoe42`

**dashboard\_path** `string | null` *required*

La plantilla de ruta URL para una vista específica de esta app, añadida al dominio base (p. ej., '/experiences/\[experienceId]'). Null si el tipo de vista especificado no está configurado.

Ejemplo: `/experiences/[experienceId]`

**default\_api\_key** `object | null` *required*

La clave de API predeterminada de la app, usada para autenticar solicitudes en nombre de esta app. Null si la app no tiene clave predeterminada. Requiere el permiso 'developer:manage\_api\_key'.

**atributos secundarios**

**id** `string` *required*

El identificador único de la clave de API autorizada.

**name** `string | null` *required*

Un nombre establecido por el usuario para identificar una clave de API

**obfuscated\_secret\_key** `string` *required*

Una versión enmascarada de la clave secreta usada para autenticar solicitudes. Así el propietario puede identificar fácilmente de qué clave se trata sin que se le muestre el secreto completo.

**secret\_key** `string | null` *required*

La clave secreta usada para autenticar solicitudes. Solo está disponible si el actor actual hubiera podido crear esta clave de API.

**description** `string | null` *required*

Una descripción escrita de lo que hace esta app, que se muestra en la página de la ficha de la tienda de apps. Null si no se ha establecido ninguna descripción.

Ejemplo: `A comprehensive analytics dashboard for tracking revenue,…`

**discover\_path** `string | null` *required*

La plantilla de ruta URL para una vista específica de esta app, añadida al dominio base (p. ej., '/experiences/\[experienceId]'). Null si el tipo de vista especificado no está configurado.

Ejemplo: `/experiences/[experienceId]`

**domain\_id** `string` *required*

El identificador de subdominio único para la URL proxy de esta app en la plataforma Whop. Forma el patrón de URL https\://\{domain\_id}.apps.whop.com.

Ejemplo: `ab1c2d3e4f5g6h7i8j9k`

**experience\_path** `string | null` *required*

La plantilla de ruta URL para una vista específica de esta app, añadida al dominio base (p. ej., '/experiences/\[experienceId]'). Null si el tipo de vista especificado no está configurado.

Ejemplo: `/experiences/[experienceId]`

**hosted\_url** `string | null` *required*

La URL canónica completa donde se sirve la compilación web alojada de esta app. Null si la app no ha reclamado una ruta.

Ejemplo: `https://myapp.whop.site`

**icon** `object | null` *required*

La imagen del icono de esta app, que se muestra en la tienda de apps, las páginas de producto, el checkout y como icono predeterminado de las experiencias que usan esta app.

**atributos secundarios**

**url** `string | null` *required*

Una URL preoptimizada para renderizar este adjunto en el cliente. Debe usarse para mostrar adjuntos en las apps.

Ejemplo: `https://media.whop.com/abc123/optimized.jpg`

**id** `string` *required*

El identificador único de la app.

Ejemplo: `app_xxxxxxxxxxxxxx`

**marketplace\_status** `MarketplaceStatuses | null` *required*

El estado de aprobación de la ficha de producto de esta app en la tienda de apps de Whop. Null si la app no tiene ningún producto asociado.

Opciones disponibles: `not_available`, `pending_review`, `live_marketplace`

**name** `string` *required*

El nombre visible de esta app que se muestra en la tienda de apps y en la navegación de experiencias. Máximo 30 caracteres.

Ejemplo: `Courses`

**oauth\_client\_type** `AppOauthClientTypes` *required*

Cómo se autentica esta app al intercambiar concesiones de autorización y de actualización de OAuth.

Opciones disponibles: `public`, `confidential`

**openapi\_path** `string | null` *required*

La plantilla de ruta URL para una vista específica de esta app, añadida al dominio base (p. ej., '/experiences/\[experienceId]'). Null si el tipo de vista especificado no está configurado.

Ejemplo: `/experiences/[experienceId]`

**origin** `string | null` *required*

La URL de origen completa del dominio proxy de esta app (p. ej., '[https://myapp.apps.whop.com](https://myapp.apps.whop.com)'). Null si no hay ningún dominio proxy configurado.

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

**production\_web\_build** `object | null` *required*

La compilación aprobada de la app que se sirve actualmente a los usuarios en la web. Null si no hay ninguna compilación de producción desplegada para la web.

**atributos secundarios**

**checksum** `string` *required*

Un hash SHA-256 del archivo de compilación subido, generado por el cliente y usado para verificar la integridad del archivo.

Ejemplo: `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7…`

**file\_url** `string` *required*

Una URL para descargar la compilación de la app como archivo .zip.

Ejemplo: `https://cdn.whop.com/builds/abc123.zip`

**id** `string` *required*

El identificador único de la compilación de la app.

Ejemplo: `apbu_xxxxxxxxxxxxx`

**source\_url** `string | null` *required*

Una URL para descargar el archivo comprimido del código fuente que produjo esta compilación. Null si la compilación se subió sin un archivo de código fuente.

Ejemplo: `https://cdn.whop.com/builds/abc123-source.zip`

**status** `AppBuildStatuses` *required*

El estado de revisión actual de esta compilación.

Opciones disponibles: `draft`, `pending`, `approved`, `rejected`

**redirect\_uris** `array\<string\>` *required*

Las URL de callback de OAuth incluidas en la lista blanca a las que se redirige a los usuarios después de autorizar la app.

**requested\_permissions** `array\<object\>` *required*

La lista de permisos que solicita esta app al instalarse, incluidos los permisos obligatorios y opcionales con sus justificaciones.

**atributos secundarios**

**is\_required** `boolean` *required*

Si la acción es necesaria para que la app funcione.

**justification** `string` *required*

El motivo por el que se solicita la acción.

**permission\_action** `object` *required*

La acción que la app solicitará a los usuarios cuando un usuario instale la app.

**atributos secundarios**

**action** `string` *required*

El identificador de la acción.

**name** `string` *required*

El nombre legible de la acción.

**route** `string | null` *required*

La ruta de subdominio única donde se sirven las compilaciones web alojadas de esta app, como 'myapp' para myapp.whop.site. Null si la app no ha reclamado una ruta.

Ejemplo: `myapp`

**secrets** `object | null` *required*

Los secretos de la app como un objeto de valores de cadena. Se cifran en reposo y se inyectan en el entorno de ejecución del servidor alojado de la app como bindings de entorno. Requiere el permiso 'developer:update\_app'.

**skills\_path** `string | null` *required*

La plantilla de ruta URL para una vista específica de esta app, añadida al dominio base (p. ej., '/experiences/\[experienceId]'). Null si el tipo de vista especificado no está configurado.

Ejemplo: `/experiences/[experienceId]`

**stats** `object | null` *required*

Estadísticas de uso agregadas de esta app, incluidos los recuentos de usuarios activos diarios, semanales y mensuales.

**atributos secundarios**

**dau** `integer` *required*

El número de usuarios únicos que han pasado tiempo en esta app en las últimas 24 horas. Devuelve 0 si no hay datos de uso disponibles.

Ejemplo: `42`

**mau** `integer` *required*

El número de usuarios únicos que han pasado tiempo en esta app en los últimos 28 días. Devuelve 0 si no hay datos de uso disponibles.

Ejemplo: `42`

**time\_spent\_last24\_hours** `integer` *required*

El tiempo total, en segundos, que todos los usuarios han pasado en esta app durante las últimas 24 horas. Devuelve 0 si no hay datos de uso disponibles.

Ejemplo: `42`

**wau** `integer` *required*

El número de usuarios únicos que han pasado tiempo en esta app en los últimos 7 días. Devuelve 0 si no hay datos de uso disponibles.

Ejemplo: `42`

**status** `AppStatuses` *required*

El estado de visibilidad actual de esta app en la tienda de apps de Whop. 'live' significa que se puede descubrir públicamente, 'unlisted' significa que solo es accesible mediante un enlace directo y 'hidden' significa que no es visible en ningún lugar.

Opciones disponibles: `live`, `unlisted`, `hidden`

**verified** `boolean` *required*

Si Whop ha verificado esta app. Las apps verificadas cuentan con el respaldo de Whop y se muestran en la sección de apps destacadas de la tienda de apps.


## Related topics

- [List Apps](https://docs.whop.com/es/api-reference/apps/list-apps.md)
- [Update App](https://docs.whop.com/es/api-reference/apps/update-app.md)
- [Update app](https://docs.whop.com/es/api-reference/legacy/apps/update-app.md)
