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

# Commandes de la Whop CLI

> Chaque groupe de commandes et sous-commande de la Whop CLI, avec les descriptions issues de la CLI elle-même.

Chaque groupe de commandes de `whop`, avec la description propre à chaque groupe. Exécutez `whop <group> --help` pour les flags, ou `whop --llms-full` pour la référence complète lisible par machine. Les commandes qui modifient l'état demandent une confirmation avant de s'exécuter.

`whop --version` affiche la version installée, et `whop --help` affiche la version de l'API utilisée par la CLI. `whop --update` installe la dernière version et renvoie `upToDate` lorsqu'il n'y en a pas (les installations Homebrew utilisent `brew upgrade whop`).

> [!WARNING]
>
> La CLI n'a pas de mode sandbox ni de mode test : chaque commande s'exécute donc en production. `whop send --dry-run` est la seule prévisualisation : elle trouve le destinataire sans rien envoyer.

## Prise en main

### `quickstart`

Configurez le compte d'entreprise que la CLI doit utiliser. Choisissez-en un ou créez-en un de manière interactive, ou passez `--account_id biz_xxx` / `--business_name`.

### `apps`

Créez et déployez des web apps entièrement hébergées sur Whop, servies sur `*.whop.site` et sur tout domaine personnalisé qui leur est associé.

| Commande | Description |
| - | - |
| `whop apps init` | Démarre le code d'une app : enregistre une nouvelle app (ou reprend une app jamais déployée avec `--app`), génère la structure et lie un projet. `--account_id` l'enregistre sur une autre entreprise, et `--template storefront` démarre une boutique complète |
| `whop apps dev` | Lance le serveur de développement local de cette app |
| `whop apps deploy` | Compile, téléverse et met en ligne cette app (`--preview` téléverse sans promouvoir) |
| `whop apps pull` | Récupère le code source déployé de l'app et le fusionne dans ce répertoire |
| `whop apps create` / `get` / `list` / `update` / `delete` | Gère les enregistrements d'apps |
| `whop apps builds get` / `list` / `promote` | Gère les builds d'apps ; promouvoir un build plus ancien permet d'effectuer un retour en arrière |
| `whop apps secrets list` / `set` / `unset` | Gère les secrets d'app, injectés en tant que bindings d'environnement dans le runtime hébergé |
| `whop apps logs` | Liste les logs de l'app |
| `whop apps categories` | Liste les catégories de l'App Store |

## Commerce

### `products`

Ce que vous vendez. Chaque produit possède des variantes et une page boutique.

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

`create` et `update` acceptent `--gallery_images` sous forme de tableau JSON d'objets contenant l'`id` d'un fichier téléversé ou un `direct_upload_id` terminé :

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

Le tableau remplace la galerie dans l'ordre d'affichage ; incluez donc chaque fichier que vous souhaitez conserver. Passez `'[]'` pour la vider. Omettre l'option préserve la galerie. `banner_image` est distinct et ne satisfait pas l'exigence de galerie de la marketplace.

### `waitlist-entries`

Rejoignez des listes d'attente et gérez les inscriptions de clients en attente d'approbation.

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

### `variants`

Configurations achetables d'un produit.

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

### `promo-codes`

Remises que les créateurs configurent pour le checkout.

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

### `memberships`

L'achat d'une variante par un client, du checkout jusqu'à l'annulation.

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

### `checkout-configurations`

Transformez une variante en lien de checkout prérempli et partageable.

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

### `shipments`

Suivez la livraison d'une commande grâce au numéro de suivi du transporteur.

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

## Ressources principales

### `accounts`

Une entreprise sur Whop : profil, portefeuille, fonctionnalités, paramètres.

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

Gérez les demandes de financement des paiements marchands d'un compte. La création d'une demande renvoie la demande ouverte existante lorsqu'il y en a une. Elle ne soumet pas la demande pour examen. C'est `submit` qui le fait, une fois que le marchand a accepté les conditions. Exécutez chaque commande avec `--help` pour connaître ses arguments de compte et de demande.

### `users`

Une personne sur Whop : profil et identités connectées.

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

`preferences` : `get` · `update`

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

### `team-members`

Les membres de l'équipe d'un compte et les rôles qui délimitent leur accès.

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

### `members`

La relation d'un acheteur avec un compte, sur l'ensemble de ses achats.

`get` · `list` · `logs`

### `economic-intelligence`

Ce qu'un compte devrait faire ensuite pour se développer, généré à partir de ses propres données.

`list` · `update`

### `webhooks`

Notifications d'événements envoyées à votre serveur au fur et à mesure qu'ils se produisent.

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

### `stats`

Rapports agrégés sur les finances, l'audience et le trafic.

`time-series` : `list` (le catalogue des métriques) · `get` (une métrique, avec filtres, ventilations et intervalles)

`reports` : `list` · `platform_trends`

Les flags de tableau se répètent (`--ad_campaign_ids adcamp_a --ad_campaign_ids adcamp_b`). Les flags d'objet acceptent du JSON, comme les étapes ordonnées d'un entonnoir :

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

Identité légale que Whop exige avant les versements et l'émission de cartes.

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

### `exports`

Exports CSV asynchrones des données du tableau de bord d'un compte.

`create` · `get` · `list`. Couvre plus de 40 ressources exportables, comme les versements, les reçus et les codes promo.

## Notifications

### `notifications`

Le fil de notifications de l'utilisateur : badges non lus, marquage comme lu, envois depuis les apps et catalogue des sujets.

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

## Paiements

### `payments`

Un prélèvement sur un acheteur, et l'étape qu'il doit encore effectuer.

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

### `payment-quotes`

Un achat dont le prix est calculé avant le paiement : ses lignes, son code promo et sa taxe.

`create` · `get`

### `refunds`

Argent restitué à un acheteur à partir d'un paiement.

`get` · `list`

### `confirmation-tokens`

Une référence de courte durée aux informations de paiement collectées auprès d'un acheteur.

`get`

### `setup-intents`

Enregistrement du moyen de paiement d'un acheteur sans le débiter.

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

### `payment-rules`

Règles qu'un compte définit pour décider de ses propres paiements.

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

### `disputes`

Rétrofacturations déposées contre un compte, avec l'historique complet des preuves.

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

### `dispute-alerts`

Avertissements de l'émetteur qui arrivent avant une rétrofacturation.

`get` · `list`

### `resolution-center-cases`

Ouvrez un dossier sur un paiement ou répondez-y, que vous soyez l'acheteur ou le marchand.

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

## Argent

### `send`

Envoyez de l'argent à une personne ou une entreprise sur Whop à partir d'un solde.

`whop send <recipient> <amount>` accepte un `@username`, une adresse e-mail, un ID `user_`, `biz_` ou `ldgr_`, ou un nom à rechercher. L'envoi se fait depuis l'entreprise utilisée par la CLI, ou depuis une autre entreprise avec `--from`. Comme toute app, la CLI ne peut pas envoyer depuis un solde personnel. Dans un terminal, elle affiche le destinataire et demande confirmation avant l'envoi. Les scripts et les agents reçoivent la commande exacte à exécuter avec `--yes` une fois que l'utilisateur a confirmé. `--dry-run` affiche le destinataire sans rien envoyer.

### `ledgers`

Le fil d'activité derrière le solde d'un compte ou d'un utilisateur.

`list` (activité financière) · `report` (récapitulatif du solde, compte de résultat, activité du solde) · `breakdown`

### `payouts`

Envoyez de l'argent d'un solde vers une banque ou un portefeuille.

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

### `cards`

Émettez des cartes qui dépensent à partir d'un solde.

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

### `cashback-rules`

Configurez le cashback sur carte financé par la plateforme.

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

### `transfers`

Transférez des fonds entre comptes et utilisateurs Whop.

`create` pour un transfert de solde ou un lien de réclamation · `get` · `get-claim-link` · `claim` · `list` · `recipients`

Envoyez depuis un solde avec `whop transfers create --type balance --origin_id biz_xxx --destination_id user_xxx --amount 10 --currency usd --idempotency-key <key>`. Trouvez l'ID d'un destinataire avec `whop transfers recipients --origin_id biz_xxx --query @username`.

Récupérez un lien de réclamation approvisionné par son ID `airdrp_` ou son code de réclamation public avec `whop transfers get-claim-link <id>`. Pour les ID de compte, l'appelant a besoin de `airdrop_link:basic:read` sur le compte qui approvisionne. Pour les ID personnels, connectez-vous en tant que propriétaire du compte. Pour les aperçus publics, utilisez le code de réclamation. `whop transfers claim <code>` en utilise un avec le code de réclamation public. Un ID de lien de réclamation n'autorise pas l'utilisation.

### `deposits`

Ajoutez des fonds à un solde.

`create`

### `swaps`

Convertissez un solde d'une devise à une autre.

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

### `trades`

Consultez l'adresse du compte de trading et ses abonnements websocket Hyperliquid, et listez les soumissions de transactions antérieures. Ces commandes ne passent pas d'ordres et ne déplacent pas de fonds. Consultez les positions en direct et les ordres ouverts depuis Hyperliquid via le websocket.

> [!NOTE]
>
> L'accès au compte de trading est disponible sur demande. Envoyez un e-mail à [support@whop.com](mailto:support@whop.com) pour obtenir l'accès.

```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` et `whop trades get` renvoient les enregistrements de soumissions antérieures, et non les exécutions en direct.

## Programme d'affiliation

### `product-affiliates`

Utilisateurs inscrits pour promouvoir un produit, y compris les affiliés sans parrainage.

`list`

## Partenaires

### `partner-referral-requests`

Demandez une attribution d'entreprise ou de partenaire et gérez son approbation.

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

### `partners`

Les utilisateurs et les entreprises que vous avez parrainés sur Whop, et ce qu'ils vous rapportent.

`create` (inscription) · `retrieve <id>` (votre ID utilisateur ou `me`) · `get` · `list` · `earnings` · `referred_users` · `leaderboard`

## Main-d'œuvre

### `bounties`

Tâches rémunérées avec soumissions examinées et récompenses placées sous séquestre.

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

### `bounty-submissions`

Travail soumis pour une prime, de la tentative jusqu'au versement.

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

## Suivi

### `people`

Visiteurs et clients d'un compte, avec leurs profils d'identité, d'achats et de trafic.

`get` · `list`

### `events`

Événements de conversion et d'engagement suivis pour l'attribution.

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

## Publicités

### `ads`

La création : texte, ressources et URL de destination.

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

### `ad-campaigns`

Plateforme, objectif et budget d'un ensemble de publicités.

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

### `ad-groups`

Audience, calendrier et budget au sein d'une campagne.

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

### `audiences`

Listes de ciblage réutilisables pour les groupes d'annonces.

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

## Médias

### `files`

Téléversez des fichiers locaux et récupérez les détails des fichiers téléversés.

`create` (`--filepath` téléverse un fichier local de bout en bout) · `get` · `list` · `complete` (termine un téléversement multipartie)

### `media`

Ressources générées par IA, facturées à partir d'un solde. Joignez-les partout où des fichiers sont acceptés.

`generate` (image ou vidéo, `--wait` bloque jusqu'à la fin) · `get`

## Identité

### `external-accounts`

Comptes sur d'autres plateformes liés à un compte ou à un utilisateur.

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

### `social-accounts`

Endpoints de compatibilité obsolètes pour les comptes externes.

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

## Développeur

### `domains`

Domaines personnalisés attribués aux apps hébergées.

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

### `api-keys`

Identifiants programmatiques d'un compte ou d'une app. La sous-commande `permissions` liste le catalogue des permissions.

`permissions` (le catalogue des permissions)

### `api-logs`

Requêtes effectuées vers l'API de Whop avec les clés API de votre compte.

`list`

### `permissions`

Ce que vos identifiants peuvent faire sur une ressource.

`check`

### `experiments`

Créez et gérez des expériences pour un compte. Passez `--account_id` pour sélectionner l'entreprise propriétaire. Les expériences de compte n'acceptent pas de tags. La création d'expériences n'est pas encore disponible pour tous les comptes.

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

### Commentaires et questions

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

Les deux commandes soumettent une observation pour examen interne par Whop et renvoient un accusé de réception. `ask-question` enregistre une question sans réponse. Elle ne renvoie pas de réponse et n'ouvre pas de conversation avec le support. Utilisez des identifiants utilisateur issus de `whop login` (OAuth via le navigateur). Retirez de `--content` les secrets, les données personnelles et les informations de paiement.

Utilisez `--account_id biz_...` pour identifier le compte d'une ressource concernée. Les deux commandes utilisent par défaut votre compte actif lorsqu'il est disponible. Le contexte de compte est facultatif.

## Authentification

### `auth`

Gérez l'authentification.

`login` · `logout` · `status` pour l'identité active · `list` · `switch` · `account`, ainsi que les alias de premier niveau `whop login` et `whop logout`

La CLI enregistre les identifiants dans `~/.config/whop/credentials.json`, chiffrés avec une clé liée à la machine. Les clients MCP ne peuvent pas exécuter ces commandes.

## Intégrations

### `skills`

Synchronisez les fichiers de skills vers les agents.

`add` · `list`. Consultez [Mode agent](https://docs.whop.com/fr/cli/agent-mode.md).

### `mcp`

Enregistrez la CLI comme serveur MCP auprès de votre agent.

`add` (`--agent claude-code` cible un seul agent, `--no-global` installe dans le projet) · `doctor` (valide le démarrage du serveur et la liste des outils). Consultez [Mode agent](https://docs.whop.com/fr/cli/agent-mode.md).

### `completions`

Générez un script d'autocomplétion pour le shell.

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


## Related topics

- [Mode agent de la Whop CLI](https://docs.whop.com/fr/cli/agent-mode.md)
- [Proxy de développement](https://docs.whop.com/fr/developer/guides/dev-proxy.md)
- [Faire de la publicité avec Whop Ads](https://docs.whop.com/fr/developer/ads/overview.md)
