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

# Comandos de la Whop CLI

> Todos los grupos de comandos y subcomandos de la Whop CLI, con descripciones de la propia CLI.

Todos los grupos de comandos de `whop`, con la descripción propia de cada grupo. Ejecuta `whop <group> --help` para ver los flags, o `whop --llms-full` para obtener la referencia completa legible por máquina. Los comandos que cambian el estado piden confirmación antes de ejecutarse.

`whop --version` imprime la versión instalada, y `whop --help` muestra la versión de la API que usa la CLI. `whop --update` instala la versión más reciente e informa `upToDate` cuando no hay ninguna (las instalaciones con Homebrew usan `brew upgrade whop`).

> [!WARNING]
>
> La CLI no tiene modo sandbox ni de prueba, así que todos los comandos se ejecutan en producción. `whop send --dry-run` es la única vista previa: encuentra al destinatario sin enviar nada.

## Primeros pasos

### `quickstart`

Configura la cuenta de negocio que debe usar la CLI. Elige o crea una de forma interactiva, o pasa `--account_id biz_xxx` / `--business_name`.

### `apps`

Crea y despliega apps web totalmente alojadas en Whop, servidas en `*.whop.site` y en cualquier dominio personalizado vinculado a ellas.

| Comando | Descripción |
| - | - |
| `whop apps init` | Inicia el código de una app: registra una app nueva (o toma una que nunca se haya desplegado con `--app`), genera la estructura y vincula un proyecto. `--account_id` la registra en otro negocio, y `--template storefront` crea una tienda completa |
| `whop apps dev` | Ejecuta el servidor de desarrollo local de esta app |
| `whop apps deploy` | Compila, sube y publica esta app (`--preview` la sube sin promocionarla) |
| `whop apps pull` | Obtiene el código fuente desplegado de la app y lo fusiona en este directorio |
| `whop apps create` / `get` / `list` / `update` / `delete` | Gestiona los registros de apps |
| `whop apps builds get` / `list` / `promote` | Gestiona las compilaciones de la app; promocionar una compilación anterior es la forma de revertir |
| `whop apps secrets list` / `set` / `unset` | Gestiona los secretos de la app, inyectados como bindings de entorno en el runtime alojado |
| `whop apps logs` | Lista los logs de la app |
| `whop apps categories` | Lista las categorías de la App Store |

## Comercio

### `products`

Lo que vendes. Cada uno tiene variantes y una página de tienda.

`create` · `get` · `list` · `update` · `delete` · `publish` · `unpublish`

`create` y `update` aceptan `--gallery_images` como un array JSON de objetos que contienen el `id` de un archivo subido o un `direct_upload_id` completado:

```bash theme={null}
whop products update prod_xxxxxxxx --gallery_images '[{"id":"file_xxxxxxxx"}]'
```

El array sustituye la galería en el orden de visualización, así que incluye todos los archivos que quieras conservar. Pasa `'[]'` para vaciarla. Si omites la opción, se conserva la galería. `banner_image` es independiente y no cumple el requisito de galería del marketplace.

### `waitlist-entries`

Únete a listas de espera y gestiona los registros de clientes pendientes de aprobación.

`create` · `get` · `list` · `approve` · `approve_all` · `deny` · `cancel`

### `variants`

Configuraciones comprables de un producto.

`create` · `get` · `list` · `update` · `delete` · `calculate_tax`

### `promo-codes`

Descuentos que los creadores configuran para el checkout.

`create` · `get` · `list` · `delete` · `activate` · `deactivate`

### `memberships`

La compra de una variante por parte de un cliente, desde el checkout hasta la cancelación.

`get` · `list` · `update` · `cancel` · `pause` · `resume` · `reactivate` · `extend` · `transfer` · `invite` · `apply_promo_code` · `assign_affiliate` · `resync_access`

### `checkout-configurations`

Convierte una variante en un enlace de checkout compartible y prerrellenado.

`create` · `get` · `list` · `delete`

### `shipments`

Sigue la entrega de un pedido mediante el número de seguimiento del transportista.

`create` · `get` · `list` · `update`

## Recursos principales

### `accounts`

Un negocio en Whop: perfil, billetera, capacidades y configuración.

`create` · `get` · `list` · `update` · `delete` · `suspend` · `form_company` · `transfer_ownership` · `preferences` · `update-preferences` · `reserves` · `retry_ads_payment`

`fees`: `get` · `update`

`financing-applications`: `list` · `get` · `create` · `update` · `submit`

Gestiona las solicitudes de financiación de pagos de comerciantes de una cuenta. Crear una solicitud devuelve la solicitud abierta existente cuando hay una. No envía la solicitud a revisión. Eso lo hace `submit` después de que el comerciante acepte los términos. Ejecuta cada comando con `--help` para ver sus argumentos de cuenta y de solicitud.

### `users`

Una persona en Whop: perfil e identidades conectadas.

`get` · `list` · `update` · `access` · `recommend_actions` · `fees`

`preferences`: `get` · `update`

`preferences notifications`: `topics` · `experiences` · `update`

### `team-members`

Los miembros del equipo de una cuenta y los roles que delimitan su acceso.

`create` · `get` · `list` · `delete`

### `members`

La relación de un comprador con una cuenta, en todas sus compras.

`get` · `list` · `logs`

### `economic-intelligence`

Lo que una cuenta debería hacer a continuación para crecer, generado a partir de sus propios datos.

`list` · `update`

### `webhooks`

Notificaciones de eventos enviadas a tu servidor a medida que ocurren.

`create` · `get` · `list` · `update` · `delete` · `test` · `deliveries` · `deliveries-replay` · `replay`

### `stats`

Informes agregados financieros, de audiencia y de tráfico.

`time-series`: `list` (el catálogo de métricas) · `get` (una métrica, con filtros, desgloses e intervalos)

`reports`: `list` · `platform_trends`

Los flags de tipo array se repiten (`--ad_campaign_ids adcamp_a --ad_campaign_ids adcamp_b`). Los flags de tipo objeto aceptan JSON, como los pasos ordenados de un embudo:

```bash theme={null}
whop stats time-series get funnel --from 2026-09-01 --to 2026-09-21 \
  --steps '{"1":{"event":"pixel.page"},"2":{"event":"payment.completed"}}'
```

### `verifications`

La identidad legal que Whop exige antes de los pagos y la emisión de tarjetas.

`create` · `get` · `list` · `update`

### `exports`

Volcados CSV asíncronos de los datos del panel de una cuenta.

`create` · `get` · `list`. Abarca más de 40 recursos exportables, como pagos, recibos y códigos promocionales.

## Notificaciones

### `notifications`

El feed de notificaciones del usuario: insignias de no leídos, marcar como leído, envíos de apps y el catálogo de temas.

`create` (enviar) · `get` · `list` · `badges` · `mark_read` · `topics`

## Pagos

### `payments`

Un cargo a un comprador y el paso que aún le queda por completar.

`create` · `get` · `list` · `update` · `capture` · `void` · `refund` · `retry` · `resume` · `fees` · `status` · `return_url`

### `payment-quotes`

Una compra con precio calculado antes del pago: sus líneas, el código promocional y los impuestos.

`create` · `get`

### `refunds`

Dinero devuelto a un comprador a partir de un pago.

`get` · `list`

### `confirmation-tokens`

Una referencia de corta duración a los datos de pago recopilados de un comprador.

`get`

### `setup-intents`

Guardar el método de pago de un comprador sin cobrarle.

`create` · `get` · `list` · `status` · `return_url`

### `payment-rules`

Reglas que escribe una cuenta para decidir sobre sus propios pagos.

`create` · `get` · `list` · `update` · `replace` · `delete` · `activate` · `deactivate` · `fields`

### `disputes`

Contracargos presentados contra una cuenta, con el historial completo de pruebas.

`get` · `list` · `update` (pruebas) · `upload_evidence` · `submit` · `summary`

### `dispute-alerts`

Avisos del emisor que llegan antes que un contracargo.

`get` · `list`

### `resolution-center-cases`

Abre o responde a un caso sobre un pago, tanto si eres el comprador como el comerciante.

`create` · `get` · `list` · `reply` · `accept` · `deny` · `appeal` · `withdraw` · `request_info` · `events` · `summary`

## Dinero

### `send`

Envía dinero desde un saldo a una persona o un negocio en Whop.

`whop send <recipient> <amount>` acepta un `@username`, una dirección de correo electrónico, un ID `user_`, `biz_` o `ldgr_`, o un nombre que buscar. Envía desde el negocio que usa la CLI, o desde otro negocio con `--from`. Como cualquier app, la CLI no puede enviar desde un saldo personal. En una terminal, muestra quién lo recibirá y pregunta antes de enviar. Los scripts y agentes obtienen el comando exacto que deben ejecutar con `--yes` una vez que el usuario confirma. `--dry-run` muestra el destinatario sin enviar nada.

### `ledgers`

El feed de actividad detrás del saldo de una cuenta o de un usuario.

`list` (actividad financiera) · `report` (resumen de saldo, estado de resultados, actividad del saldo) · `breakdown`

### `payouts`

Envía dinero desde un saldo a un banco o una billetera.

`create` · `get` · `list` · `cancel` · `quotes` · `methods` · `create-method` · `update-method` · `delete-method` · `supported-methods`

### `cards`

Emite tarjetas que gastan desde un saldo.

`create` · `get` · `list` · `update` · `transactions` · `get-transaction`

### `cashback-rules`

Configura el cashback de tarjetas patrocinado por la plataforma.

`create` · `list` · `update` · `payout`

### `transfers`

Mueve fondos entre cuentas y usuarios de Whop.

`create` para una transferencia de saldo o un enlace de reclamación · `get` · `get-claim-link` · `claim` · `list` · `recipients`

Envía desde un saldo con `whop transfers create --type balance --origin_id biz_xxx --destination_id user_xxx --amount 10 --currency usd --idempotency-key <key>`. Encuentra el ID de un destinatario con `whop transfers recipients --origin_id biz_xxx --query @username`.

Obtén un enlace de reclamación con fondos por su ID `airdrp_` o por su código de reclamación público con `whop transfers get-claim-link <id>`. Para los IDs de cuenta, quien llama necesita `airdrop_link:basic:read` en la cuenta que aporta los fondos. Para los IDs personales, inicia sesión como propietario de la cuenta. Para las vistas previas públicas, usa el código de reclamación. `whop transfers claim <code>` canjea uno con el código de reclamación público. Un ID de enlace de reclamación no autoriza el canje.

### `deposits`

Añade fondos a un saldo.

`create`

### `swaps`

Convierte un saldo entre divisas.

`create` · `get` · `quote` · `status`

### `trades`

Lee la dirección de la cuenta de trading y sus suscripciones de websocket de Hyperliquid, y lista los envíos de operaciones anteriores. Estos comandos no colocan órdenes ni mueven fondos. Lee las posiciones en vivo y las órdenes abiertas desde Hyperliquid a través del websocket.

> [!NOTE]
>
> El acceso a la cuenta de trading está disponible bajo solicitud. Escribe a [support@whop.com](mailto:support@whop.com) para obtener acceso.

```bash theme={null}
whop accounts get biz_xxx --include_trading true --format json
whop users get me --include_trading true --format json
whop trades list --format json
whop trades get trop_xxx --format json
```

`whop trades list` y `whop trades get` devuelven registros de envíos anteriores, no ejecuciones en vivo.

## Programa de afiliados

### `product-affiliates`

Usuarios inscritos para promocionar un producto, incluidos los afiliados sin referidos.

`list`

## Partners

### `partner-referral-requests`

Solicita la atribución de un negocio o un partner y gestiona su aprobación.

`create` · `get` · `list` · `accept` · `decline` · `cancel`

### `partners`

Los usuarios y negocios que referiste a Whop, y lo que ganas con ellos.

`create` (inscribirse) · `retrieve <id>` (tu ID de usuario o `me`) · `get` · `list` · `earnings` · `referred_users` · `leaderboard`

## Personal

### `bounties`

Tareas remuneradas con envíos revisados y recompensas en depósito de garantía.

`create` · `get` · `list` · `update` · `cancel` · `submissions` · `get-submission`

### `bounty-submissions`

Trabajo enviado a una bounty, desde el intento hasta el pago.

`create` · `get` · `list` · `submit` · `delete` (cancelar)

## Seguimiento

### `people`

Visitantes y clientes de una cuenta, con perfiles de identidad, compras y tráfico.

`get` · `list`

### `events`

Eventos de conversión e interacción registrados para la atribución.

`create` · `list` · `pulse` · `validate_pixel`

## Anuncios

### `ads`

La creatividad: texto, recursos y URL de destino.

`create` · `get` · `list` · `update` · `delete` · `duplicate` · `pause` · `unpause`

### `ad-campaigns`

Plataforma, objetivo y presupuesto de un conjunto de anuncios.

`create` · `get` · `list` · `update` · `delete` · `duplicate` · `pause` · `unpause` · `retry_payment`

### `ad-groups`

Audiencia, calendario y presupuesto dentro de una campaña.

`create` · `get` · `list` · `update` · `delete` · `duplicate` · `pause` · `unpause`

### `audiences`

Listas de segmentación reutilizables para grupos de anuncios.

`create` · `list` · `update` · `delete` · `add_people`

## Multimedia

### `files`

Sube archivos locales y obtén los detalles de los archivos subidos.

`create` (`--filepath` sube un archivo local de principio a fin) · `get` · `list` · `complete` (finaliza una subida multiparte)

### `media`

Recursos generados por IA, facturados desde un saldo. Adjúntalos en cualquier lugar que acepte archivos.

`generate` (imagen o vídeo; `--wait` bloquea hasta que termina) · `get`

## Identidad

### `external-accounts`

Cuentas en otras plataformas vinculadas a una cuenta o a un usuario.

`connect` · `create` · `list` · `delete` · `refresh` · `posts` · `lead_forms` · `partners` · `add-partner` · `remove-partner`

### `social-accounts`

Endpoints de compatibilidad obsoletos para cuentas externas.

`connect` · `create` · `list` · `delete` · `refresh` · `posts` · `lead_forms` · `partners` · `add-partner` · `remove-partner`

## Desarrollador

### `domains`

Dominios personalizados asignados a apps alojadas.

`get` · `list` · `update` · `delete`

### `api-keys`

Credenciales programáticas para una cuenta o una app. El subcomando `permissions` lista el catálogo de permisos.

`permissions` (el catálogo de permisos)

### `api-logs`

Solicitudes realizadas a la API de Whop con las API keys de tu cuenta.

`list`

### `permissions`

Lo que tu credencial puede hacer sobre un recurso.

`check`

### `experiments`

Crea y gestiona experimentos para una cuenta. Pasa `--account_id` para seleccionar el negocio propietario. Los experimentos de cuenta no aceptan etiquetas. La creación de experimentos aún no está disponible para todas las cuentas.

`list` · `create` · `get` · `update` · `exposures` · `activate` · `pause` · `end`

### Comentarios y preguntas

```bash theme={null}
whop report-feedback --content "The error message does not explain which permission is missing."
whop ask-question --content "How do trials interact with an existing subscription?" --format json
```

Ambos comandos envían una observación para la revisión interna de Whop y devuelven un comprobante. `ask-question` registra una pregunta sin responder. No devuelve una respuesta ni inicia una conversación de soporte. Usa una credencial de usuario de `whop login` (OAuth en el navegador). Elimina secretos, datos personales y datos de pago de `--content`.

Usa `--account_id biz_...` para identificar la cuenta de un recurso afectado. Ambos comandos usan tu cuenta activa de forma predeterminada cuando está disponible. El contexto de cuenta es opcional.

## Autenticación

### `auth`

Gestiona la autenticación.

`login` · `logout` · `status` para la identidad activa · `list` · `switch` · `account`, además de los alias de nivel superior `whop login` y `whop logout`

La CLI guarda las credenciales en `~/.config/whop/credentials.json`, cifradas con una clave vinculada a la máquina. Los clientes MCP no pueden ejecutar estos comandos.

## Integraciones

### `skills`

Sincroniza archivos de skills con los agentes.

`add` · `list`. Consulta [Modo agente](https://docs.whop.com/es/cli/agent-mode.md).

### `mcp`

Registra la CLI como servidor MCP en tu agente.

`add` (`--agent claude-code` apunta a un agente, `--no-global` lo instala en el proyecto) · `doctor` (valida el arranque del servidor y el listado de herramientas). Consulta [Modo agente](https://docs.whop.com/es/cli/agent-mode.md).

### `completions`

Genera el script de autocompletado del shell.

`whop completions <bash|fish|nushell|zsh>`


## Related topics

- [Modo agente de la Whop CLI](https://docs.whop.com/es/cli/agent-mode.md)
- [Crea apps de Whop con React Native](https://docs.whop.com/es/developer/guides/react-native.md)
- [Herramientas de IA para construir en Whop](https://docs.whop.com/es/developer/ai/overview.md)
