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

> Configureer de machtigingen die je app nodig heeft en vraag goedkeuring aan de creators die de app installeren.

Apps gebruiken machtigingen om accountgegevens te benaderen en namens gebruikers te handelen. Elke API-aanroep vereist de bijbehorende machtiging. Je declareert de machtigingen die je nodig hebt in de instellingen van je app, creators keuren ze goed bij de installatie, en je SDK-aanroepen slagen pas nadat creators die machtigingen hebben verleend.

> [!TIP]
>
> Je vindt de vereiste machtigingen voor elk endpoint in de API-referentie. Elke operatiepagina vermeldt ze onder "Required permissions."

## Vereiste en optionele machtigingen

Je kunt elke machtiging markeren als vereist of optioneel. Die keuze verandert de installatie-ervaring voor creators.

| Type | Creator kan uitschakelen bij installatie | Gebruik wanneer |
| - | - | - |
| **Vereist** | Nee | De app kan niet functioneren zonder deze scope |
| **Optioneel** | Ja | De scope drijft een nevenfunctie aan, niet de kernflow (bijv. opt-in voor analytics) |

Optionele machtigingen zijn handig voor opt-in-functionaliteit. Als een creator een optionele machtiging weigert, moet je app nog steeds werken, alleen zonder die functie.

## Machtigingen instellen

> [!WARNING]
>
> De machtigingsflow is ook vereist als je op je eigen account test. Het is dezelfde flow bij installatie of zelftest, zodat je ontbrekende scopes vroeg opmerkt.

**1. Open het machtigingentabblad van je app**

1. Ga naar het [Developer-dashboard](https://whop.com/dashboard/developer).
2. Selecteer of maak een app.
3. Selecteer het tabblad **Permissions**.

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

**2. Voeg de machtigingen toe die je nodig hebt**

Selecteer **Add permissions**, selecteer wat je app nodig heeft en bevestig.

Vergelijk met de API-endpoints die je wilt aanroepen en voeg elke machtiging toe die ze vereisen.

**3. Configureer elke machtiging**

Voor elke machtiging:

1. Schrijf een korte onderbouwing waarin je uitlegt waarom de app de machtiging nodig heeft. Creators zien dit bij de installatie, en elke machtiging heeft een eigen onderbouwing nodig om te voldoen aan de [vermeldingsvereisten van de App Store](https://docs.whop.com/nl/developer/apps/listing-requirements.md).
2. Markeer de machtiging als **vereist** of **optioneel**.

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

**4. Sla op**

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

**5. Installeer op een testaccount**

Bezoek je directe installatielink: `https://whop.com/apps/app_xxxxxxxxx/install`.

Kies een account, bekijk de machtigingsprompt en keur goed.

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

## Machtigingen later bijwerken

Machtigingen kunnen veranderen naarmate de app zich ontwikkelt. Wanneer je een nieuwe toevoegt:

* Bestaande installaties zien een knop **Re-approve** naast je app.
* API-aanroepen die de nieuwe machtiging nodig hebben, mislukken totdat elke creator opnieuw goedkeurt.

> [!NOTE]
>
> Wanneer je een machtiging toevoegt, keur die dan ook opnieuw goed op je eigen testaccount. Nieuwe scopes worden pas overgenomen wanneer je ze accepteert in [Authorized apps](https://whop.com/dashboard/settings/authorized-apps).

Creators kunnen verleende machtigingen op elk moment beheren via `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" />

## Veelgestelde vragen

> [accordion] Hoeveel machtigingen kan een app aanvragen?
>
> Maximaal 100 per app.

> [accordion] Waar staan de vereiste machtigingen voor een endpoint?
>
> Elk endpoint in de [API-referentie](https://docs.whop.com/nl/api-reference/payments/list-payments.md) vermeldt de vereiste machtigingen inline.
>
> ![Vereiste machtigingen in de SDK-referentie](https://mintcdn.com/whop/purcney6SuEUQzS5/images/sdk-reference-required-permissions.png?fit=max\&auto=format\&n=purcney6SuEUQzS5\&q=85\&s=141d5a09a00942f216c98d233824dcf9)

> [accordion] Kan een app achteraf extra machtigingen aanvragen?
>
> Ja. Je kunt extra machtigingen aanvragen en de creator wordt gevraagd die opnieuw goed te keuren.
>
> > [!NOTE]
> >
> > Totdat de machtigingen opnieuw zijn goedgekeurd, mislukken API-requests die de **nieuw aangevraagde** machtigingen vereisen. Zorg ervoor dat je code deze fouten afhandelt en een bruikbaar alternatief biedt.
>
> > [!WARNING]
> >
> > Zorg er tijdens het ontwikkelen van je app voor dat je de machtigingen zelf opnieuw goedkeurt in je instellingen bij [Authorized apps](https://whop.com/dashboard/settings/authorized-apps).
> >
> > Zie [Je machtigingen configureren](https://docs.whop.com/nl/developer/guides/permissions.md#update-permissions-later) voor meer informatie.

## Volgende stappen

> [card] [Authenticatie](https://docs.whop.com/nl/developer/guides/authentication.md)
>
> Verifieer de gebruiker achter een request en controleer diens toegangsniveau.

> [card] [Luisteren naar webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md)
>
> Ontvang betalings-, lidmaatschaps- en entry-events. Webhooks hebben hun eigen `webhook_receive:*`-scopes nodig.

> [card] [Installaties bijhouden](https://docs.whop.com/nl/developer/guides/app-installations.md)
>
> Weet wanneer een account je app installeert of verwijdert, en koppel dat aan je eigen gegevens.

> [card] [App-weergaven bouwen](https://docs.whop.com/nl/developer/guides/app-views.md)
>
> Stel dashboardweergaven, experiences en discover-vermeldingen in.

> [card] [Een lokale development-proxy draaien](https://docs.whop.com/nl/developer/guides/dev-proxy.md)
>
> Bootst de iframe- en cookie-setup van productie na op localhost.


## Related topics

- [Apps API](https://docs.whop.com/nl/api-reference/apps/app.md)
- [OAuth](https://docs.whop.com/nl/developer/guides/oauth.md)
- [Pushmeldingen](https://docs.whop.com/nl/developer/guides/notifications.md)
