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

# Solicita permisos para tu app

> Configura los permisos que necesita tu app y solicita la aprobación de los creadores que la instalan.

Las apps usan permisos para acceder a los datos de la cuenta y actuar en nombre de los usuarios. Cada llamada a la API requiere el permiso correspondiente. Declaras los que necesitas en la configuración de tu app, los creadores los aprueban al instalarla y tus llamadas al SDK solo funcionan después de que los creadores concedan esos permisos.

> [!TIP]
>
> Encuentra los permisos requeridos para cualquier endpoint en la referencia de la API. Cada página de operación los indica en "Required permissions".

## Permisos obligatorios y opcionales

Puedes marcar cada permiso como obligatorio u opcional. La elección cambia la experiencia de instalación para los creadores.

| Tipo | El creador puede desactivarlo al instalar | Úsalo cuando |
| - | - | - |
| **Obligatorio** | No | La app no puede funcionar sin este scope |
| **Opcional** | Sí | El scope habilita una función secundaria, no el flujo principal (p. ej., analíticas con aceptación voluntaria) |

Los permisos opcionales son útiles para funcionalidades de aceptación voluntaria. Si un creador rechaza un permiso opcional, tu app debería seguir funcionando, solo que sin esa función.

## Configura los permisos

> [!WARNING]
>
> El flujo de permisos es obligatorio incluso para hacer pruebas en tu propia cuenta. Es el mismo flujo al instalar o al probar por tu cuenta, así detectas pronto los scopes que faltan.

**1. Abre la pestaña de permisos de tu app**

1. Ve al [panel de desarrollador](https://whop.com/dashboard/developer).
2. Selecciona o crea una app.
3. Selecciona la pestaña **Permissions**.

![Configuración de permisos](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=514a98987e714d5a2542b3d7665020f7)

**2. Añade los permisos que necesitas**

Selecciona **Add permissions**, elige lo que necesita tu app y confirma.

Revisa los endpoints de la API que piensas llamar y añade todos los permisos que requieren.

**3. Configura cada permiso**

Para cada uno:

1. Escribe una breve justificación que explique por qué la app lo necesita. Los creadores la ven al instalar, y cada permiso necesita su propia justificación para cumplir los [requisitos de publicación en la App Store](https://docs.whop.com/es/developer/apps/listing-requirements.md).
2. Márcalo como **obligatorio** u **opcional**.

![Justificación de permisos](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings-justification.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=93ec46a13be088ad236a7fe69f6f6ad2)

**4. Guarda**

![Guardar la configuración de permisos](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings-save.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=683b42f4dcfed0eeee535d82dcce3e5f)

**5. Instala en una cuenta de prueba**

Visita tu enlace de instalación directa: `https://whop.com/apps/app_xxxxxxxxx/install`.

Elige una cuenta, revisa la solicitud de permisos y apruébala.

![Solicitud de permisos](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-oauth.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=4b427b52f269ee6b92fcf7434069ad43)

## Actualiza los permisos más adelante

Los permisos pueden cambiar a medida que evoluciona la app. Cuando añades uno nuevo:

* Las instalaciones existentes ven un botón **Re-approve** junto a tu app.
* Las llamadas a la API que necesitan el nuevo permiso fallan hasta que cada creador lo vuelva a aprobar.

> [!NOTE]
>
> Cuando añadas un permiso, vuelve a aprobarlo también en tu propia cuenta de prueba. Los nuevos scopes no se aplican hasta que los aceptas en [Authorized apps](https://whop.com/dashboard/settings/authorized-apps).

Los creadores pueden gestionar los permisos concedidos en cualquier momento en `Dashboard → Settings → Authorized apps`.

<video controls src="https://mintcdn.com/whop/_aQsA39rzB5Zq8ZK/how-to-videos/configure-app-permissions.mp4?fit=max&auto=format&n=_aQsA39rzB5Zq8ZK&q=85&s=dff99f10fb43e8914fdcd1b0eb4bd044" />

## Preguntas frecuentes

> [accordion] ¿Cuántos permisos puede solicitar una app?
>
> Hasta 100 por app.

> [accordion] ¿Dónde se indican los permisos requeridos de un endpoint?
>
> Cada endpoint de la [referencia de la API](https://docs.whop.com/es/api-reference/payments/list-payments.md) indica sus permisos requeridos en línea.
>
> ![Permisos en la referencia del SDK](https://mintcdn.com/whop/purcney6SuEUQzS5/images/sdk-reference-required-permissions.png?fit=max\&auto=format\&n=purcney6SuEUQzS5\&q=85\&s=141d5a09a00942f216c98d233824dcf9)

> [accordion] ¿Puede una app solicitar permisos adicionales después?
>
> Sí. Puedes solicitar permisos adicionales y se pedirá al creador que los vuelva a aprobar.
>
> > [!NOTE]
> >
> > Hasta que se vuelvan a aprobar los permisos, las solicitudes a la API que requieran los permisos **recién solicitados** fallarán. Asegúrate de que tu código gestione estos errores y ofrezca una alternativa útil.
>
> > [!WARNING]
> >
> > Mientras desarrollas tu app, asegúrate de volver a aprobar tú mismo los permisos en la configuración de [Authorized apps](https://whop.com/dashboard/settings/authorized-apps).
> >
> > Consulta [Configura tus permisos](https://docs.whop.com/es/developer/guides/permissions.md#update-permissions-later) para obtener más información.

## Próximos pasos

> [card] [Autenticación](https://docs.whop.com/es/developer/guides/authentication.md)
>
> Verifica el usuario detrás de una solicitud y comprueba su nivel de acceso.

> [card] [Escucha webhooks](https://docs.whop.com/es/developer/guides/webhooks.md)
>
> Recibe eventos de pagos, membresías y entradas. Los webhooks necesitan sus propios scopes `webhook_receive:*`.

> [card] [Rastrea instalaciones](https://docs.whop.com/es/developer/guides/app-installations.md)
>
> Sabe cuándo una cuenta instala o elimina tu app y vincúlala a tus propios registros.

> [card] [Crea vistas de app](https://docs.whop.com/es/developer/guides/app-views.md)
>
> Configura vistas del panel, experiencias y fichas de descubrimiento.

> [card] [Ejecuta un proxy de desarrollo local](https://docs.whop.com/es/developer/guides/dev-proxy.md)
>
> Replica en localhost la configuración de iframe + cookies de producción.


## Related topics

- [Notificaciones push](https://docs.whop.com/es/developer/guides/notifications.md)
- [Solución de problemas de integraciones con Whop](https://docs.whop.com/es/developer/troubleshooting.md)
- [Requisitos para publicar en la App Store](https://docs.whop.com/es/developer/apps/listing-requirements.md)
