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

# Authenticatie en API-sleutels

> De vijf soorten Whop-inloggegevens, wanneer je welke gebruikt en hoe je de scope van inloggegevens beperkt tot de acties die echt nodig zijn.

Whop heeft vijf soorten inloggegevens. Welke je nodig hebt, hangt af van wiens data je benadert en waar de code draait. Kies uit deze tabel en beperk daarna de scope van de inloggegevens voordat ze in de buurt van productie komen.

| Inloggegevens | Treedt op als | Bevindt zich | Gebruik wanneer |
| - | - | - | - |
| **API-sleutel** | Je account of je app | Je server | Je backend je eigen account benadert, of elk account dat je app heeft geïnstalleerd |
| **Gebruikerstoken met accountscope** | Eén gebruiker, binnen één account | Aangemaakt op je server, gebruikt in je client | Je product al eigen gebruikers heeft en die Whop moeten kunnen bereiken zonder zich bij Whop aan te melden |
| **Accounttoegangstoken** | Je account, met beperkte permissies | Aangemaakt op je server, gebruikt in je client | Een client tijdelijk toegang tot je account nodig heeft zonder je API-sleutel te bezitten |
| **iframe-gebruikerstoken** | De gebruiker die je app bekijkt | Verstuurd door Whop, geverifieerd door jou | Je app binnen Whop wordt weergegeven en je moet weten wie ernaar kijkt |
| **OAuth-token** | Een gebruiker die zich bij Whop heeft aangemeld | Je server, na de OAuth-flow | Je wilt dat gebruikers zich aanmelden met Whop en je app toegang geven tot hun account |

## API-sleutels

Een Account API-sleutel authenticeert je server als één account. Een App API-sleutel authenticeert je app bij elk account dat de app heeft geïnstalleerd. Beide zijn geheim: houd ze server-side.

### Een Account API-sleutel aanmaken

Gebruik een Account API-sleutel wanneer je server optreedt namens je eigen account en de [subaccounts](https://docs.whop.com/nl/developer/platforms/enroll-subaccounts.md) daarvan. Open op de Developer-pagina van het dashboard **Account API Keys** en selecteer **Create**. De [Quickstart](https://docs.whop.com/nl/developer/quickstart.md) loopt dit stap voor stap door in de sandbox.

### Een App API-sleutel aanmaken

Gebruik een App API-sleutel wanneer je een app bouwt en toegang nodig hebt tot data van de accounts die de app hebben geïnstalleerd.

1. Open **Apps** in het dashboard.
2. Selecteer **Create app** en geef je app een naam. Je kunt de naam later wijzigen.
3. Je sleutel is de verborgen waarde na `WHOP_API_KEY` in de sectie **Environment variables**. Gebruik de knop om hem zichtbaar te maken en bewaar hem op een veilige plek.

## Gebruikerstokens met accountscope

Een gebruikerstoken met accountscope treedt op als één specifieke gebruiker binnen één specifiek account. Je server maakt het aan met je API-sleutel en geeft het door aan je client, zodat je gebruikers Whop bereiken zonder zich ooit bij Whop aan te melden.

Maak er een aan met `POST /api/v1/access_tokens` en geef `account_id`, `user_id` en de acties die je wilt toestaan mee:

```bash theme={null}
curl https://api.whop.com/api/v1/access_tokens \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "biz_XXXXXXXX",
    "user_id": "user_XXXXXXXX",
    "scoped_actions": ["chat:read", "chat:message:create"]
  }'
```

`account_id` begint met `biz_` en `user_id` begint met `user_`. Je API-sleutel moet toestemming hebben om beide te benaderen.

Tokens verlopen standaard na **één uur**. Stel `expires_at` in om dat te wijzigen, tot een maximum van **drie uur**. Maak ze aan wanneer je ze nodig hebt in plaats van ze te cachen.

> [!NOTE]
>
> Zie [Toegangstoken aanmaken](https://docs.whop.com/nl/api-reference/legacy/access-tokens/create-access-token.md).

### De scope van een token beperken

`scoped_actions` is de lijst met dingen die het token mag doen. Elk item is een actiestring met dubbele punten als scheidingsteken.

> [!WARNING]
>
> Laat je `scoped_actions` leeg of weg, dan **erft het token alle permissies van de inloggegevens waarmee het is aangemaakt**. Een token dat aan een browser wordt gegeven, heeft dan het volledige bereik van je API-sleutel. Geef altijd een expliciete lijst mee.

Een actie moet een subset zijn van de permissies van de inloggegevens waarmee het token wordt aangemaakt. Je kunt niets toekennen wat je API-sleutel zelf niet heeft.

Deze acties komen momenteel voor in de gidsen van Whop:

| Actie | Geeft toegang tot |
| - | - |
| `chat:read` | Chatkanalen en berichten lezen |
| `chat:message:create` | Chatberichten versturen |
| `dms:read` | Directe berichten lezen |
| `dms:message:manage` | Directe berichten versturen en beheren |
| `dms:channel:manage` | DM-kanalen aanmaken en beheren |
| `support_chat:read` | Supportchats lezen |
| `support_chat:message:create` | Supportchatberichten versturen |
| `company:balance:read` | Het saldo van een account lezen |

De API publiceert geen vaste lijst, dus beschouw dit als de gedocumenteerde set en niet als de volledige set. De doorslaggevende grens zijn altijd de permissies van de inloggegevens waarmee het token wordt aangemaakt.

## Accounttoegangstokens

Een accounttoegangstoken treedt op als het account zelf, zonder gekoppelde gebruiker. Maak er een aan met `POST /api/v1/access_tokens` en geef alleen `account_id` en de toe te staan `scoped_actions` mee. Het verloopt volgens hetzelfde schema als een gebruikerstoken met accountscope.

Gebruik het wanneer een client korte tijd de toegang van je account nodig heeft, zoals een ingesloten component, en er geen specifieke gebruiker bij betrokken is. Endpoints die optreden als een gebruiker, zoals endpoints voor meldingen of voorkeuren, weigeren het.

## `iframe`-gebruikerstokens

Wanneer je app binnen Whop wordt weergegeven, bevat elk same-origin-request een kortlevende JWT in de header `x-whop-user-token`. Je verifieert de handtekening om te weten wie de aanvraag doet en controleert daarna wat die persoon mag zien. De Python- en Ruby-SDK's bevatten hiervoor een helper. De TypeScript-SDK niet, dus verifieer de JWT daar zelf.

Dit token maak je nooit zelf aan. Whop verstuurt het en jij valideert het. Zie [Authenticatie](https://docs.whop.com/nl/developer/guides/authentication.md).

## OAuth-tokens

Een OAuth-token vertegenwoordigt een gebruiker die zich bij Whop heeft aangemeld en je app heeft goedgekeurd voor een reeks scopes. Anders dan bij een API-sleutel is het bereik beperkt tot wat die individuele gebruiker kan doen.

Gebruik het voor Sign in with Whop en om namens een gebruiker acties uit te voeren op diens eigen account. Zie [OAuth](https://docs.whop.com/nl/developer/guides/oauth.md).

## Checklist voor scopes

Voordat inloggegevens in productie komen:

* Geef bij elk aangemaakt token expliciete `scoped_actions` mee. Vertrouw nooit op overerving.
* Geef API-sleutels een aangepaste set permissies zodra je weet welke endpoints je aanroept, in plaats van ze op Admin te laten staan.
* Houd API-sleutels server-side. Alleen gebruikerstokens horen in een client.
* Maak kortlevende tokens aan wanneer je ze nodig hebt in plaats van langlevende tokens te cachen.
* Gebruik aparte inloggegevens per omgeving en controleer welke je gebruikt voordat je iets uitvoert waarbij geld wordt verplaatst.

## Volgende stappen

> [card] [Quickstart](https://docs.whop.com/nl/developer/quickstart.md)
>
> Maak een sandboxsleutel aan en doe je eerste aanroep.

> [card] [Kernconcepten](https://docs.whop.com/nl/developer/concepts.md)
>
> Hoe accounts, gebruikers en permissies met elkaar samenhangen.

> [card] [OAuth](https://docs.whop.com/nl/developer/guides/oauth.md)
>
> De volledige OAuth 2.1- en PKCE-flow.

> [card] [Testen in de sandbox](https://docs.whop.com/nl/developer/guides/sandbox.md)
>
> Probeer inloggegevens eerst uit op testdata.


## Related topics

- [Een project starten vanuit een blueprint](https://docs.whop.com/nl/developer/guides/blueprints.md)
- [Chatauthenticatie](https://docs.whop.com/nl/developer/guides/chat/authentication.md)
- [Testen in de sandbox](https://docs.whop.com/nl/developer/guides/sandbox.md)
