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

# Migreren vanaf eerdere versies

> Verplaats een integratie van API v2 of de openbare GraphQL API. Vind de vervanger in de Current API voor elke route of bewerking en wat er anders werkt.

Whop stopt met twee oudere API's. Beide gaan over naar de Current API op `https://api.whop.com/api/v1`, met dezelfde API-sleutels.

| Als je integratie dit aanroept | Werkt niet meer vanaf | Gids |
| - | - | - |
| `https://api.whop.com/api/v2` of `https://api.whop.com/v2` | 13 november 2026 | [API v2](#v2) |
| `https://api.whop.com/public-graphql`, of het pakket `@whop/api` gebruikt | 26 oktober 2026 | [Public GraphQL](#public-graphql) |

## Overstappen naar de Current API

**1. Behoud je API-sleutel**

De Current API gebruikt dezelfde API-sleutels voor accounts en apps. Als een verzoek `403` retourneert, mist de sleutel de machtiging die dat endpoint nodig heeft. Voeg die toe onder **Developer → API keys**, of vraag hem aan in de machtigingen van je app.

**2. Installeer de SDK en pin een versie**

De officiële SDK's roepen de Current API aan en sturen de API-versie mee waarvoor ze zijn gebouwd. Gebruik je `@whop/api`, vervang die dan door `@whop/sdk`. De helpers `withUser` en `withCompany` daarvan hebben geen equivalent: geef in plaats daarvan bij elk verzoek de gebruikers- of account-ID mee.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({ token: process.env.WHOP_API_KEY });

const access = await client.users.checkAccess({
  id: "user_xxxxxxxxxxxxx",
  resource_id: "exp_xxxxxxxxxxxxx",
});
```

```python Python theme={null}
import os

from whop_sdk import Whop

client = Whop(token=os.environ["WHOP_API_KEY"])

membership = client.memberships.retrieve("mem_xxxxxxxxxxxxx")
```

```bash cURL theme={null}
curl https://api.whop.com/api/v1/memberships/mem_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-08-21-1"
```

Roep je de API aan zonder SDK, stuur dan bij elk verzoek `Api-Version-Date` mee. [API-versies](https://docs.whop.com/nl/developer/api/versioning.md) legt uit hoe pinnen werkt.

**3. Vervang elke aanroep**

Gebruik het tabblad voor de API die je verlaat en verwijder daarna de oude basis-URL of het oude pakket uit je code.

> [tab] API v2
>
> ### Je v2-aanroepen vinden
>
> Elke v2-respons bevat drie headers:
>
> | Header | Voorbeeld | Betekenis |
> | - | - | - |
> | `Deprecation` | `@1791417600` | Whop heeft dit endpoint verouderd verklaard. De waarde is de datum van veroudering in Unix-seconden. |
> | `Sunset` | `Fri, 13 Nov 2026 00:00:00 GMT` | API v2 werkt niet meer vanaf 13 november 2026. |
> | `Link` | `<https://api.whop.com/api/v1/memberships/mem_xxxxxxxxxxxxx>; rel="successor-version", <https://docs.whop.com/developer/api/migrate-from-previous-versions#v2>; rel="deprecation"` | De `successor-version`-URL is het verzoek in de Current API dat dit verzoek vervangt. De `deprecation`-URL is deze gids. |
>
> Log responsen die `Deprecation` bevatten om elke v2-aanroep te vinden die je integratie nog doet.
>
> ### Routeoverzicht
>
> #### Lidmaatschappen en licenties
>
> | v2-route | Current API | Opmerkingen |
> | - | - | - |
> | `GET /memberships` | `GET /memberships` | Cursorpaginering. Zie [Paginering](#pagination). Vervang `discord_id=<id>` door `external_account=discord_<id>`. |
> | `GET /memberships/{id}` | `GET /memberships/{id}` | Accepteert ook een licentiesleutel in plaats van de `mem_`-ID. |
> | `POST /memberships/{id}` | `PATCH /memberships/{id}` | Stuur `metadata` om sleutels samen te voegen. Stuur `{}` om het te wissen. |
> | `POST /memberships/{id}/cancel` | `POST /memberships/{id}/cancel` | Geef `cancel_at_period_end: true` mee om de toegang te behouden tot de verlengingsdatum. |
> | `POST /memberships/{id}/terminate` | `POST /memberships/{id}/cancel` | Laat `cancel_at_period_end` weg om de toegang direct in te trekken. |
> | `POST /memberships/{id}/add_free_days` | `POST /memberships/{id}/extend` | |
> | `POST /memberships/{id}/validate_license` | `GET /memberships/{id}` en `PATCH /memberships/{id}` | Controleer de sleutel en koppel een machine vanaf je server. Zie [Licentiesleutels](#license-keys). |
> | `GET /licenses` | `GET /memberships` | Elk lidmaatschap heeft een `license_key` wanneer het product de Software-app bevat. |
>
> #### Leden en klanten
>
> | v2-route | Current API | Opmerkingen |
> | - | - | - |
> | `GET /members` | `GET /members` | |
> | `GET /customers` | `GET /members` | Klanten en leden zijn dezelfde resource. |
> | `GET /members/{search}` | `GET /members` | Filter met `user_ids` of `query`. `GET /members/{id}` accepteert alleen een `mber_`-ID. Om een lid te vinden op Discord-ID roep je `GET /memberships?external_account=discord_<id>` aan en lees je de `member_id` van elk lidmaatschap. |
> | `GET /customers/{search}` | `GET /members` | Hetzelfde als hierboven. |
>
> #### Betalingen en checkout
>
> | v2-route | Current API | Opmerkingen |
> | - | - | - |
> | `GET /payments` | `GET /payments` | Filters zijn enkelvoudig, zoals `status` en `membership_id`. |
> | `GET /payments/{id}` | `GET /payments/{id}` | |
> | `POST /payments/{id}/refund` | `POST /payments/{id}/refund` | |
> | `GET /payment_fees?payment_id=` | `GET /payments/{id}/fees` | |
> | `GET /payment_methods` | `GET /payment_methods` | |
> | `POST /checkout_requests` | `POST /payments` | Geef `member_id` (`mber_`) en `payment_method_id` mee. De respons is de betaling. |
> | `GET /checkout_requests/{id}` | `GET /payments/{id}` | `POST /payments` retourneert de betaling direct, dus je hoeft niet te pollen. |
> | `GET /checkout_sessions` | `GET /checkout_configurations` | Checkoutsessies heten nu checkoutconfiguraties. |
> | `GET /checkout_sessions/{id}` | `GET /checkout_configurations/{id}` | |
> | `POST /checkout_sessions` | `POST /checkout_configurations` | De respons bevat `purchase_url`. |
> | `DELETE /checkout_sessions/{id}` | `DELETE /checkout_configurations/{id}` | |
>
> #### Producten en plannen
>
> Plannen heten nu varianten. Variant-ID's behouden de prefix `plan_`, dus opgeslagen ID's blijven werken.
>
> | v2-route | Current API | Opmerkingen |
> | - | - | - |
> | `GET /products`, `GET /access_passes` | `GET /products` | Access passes heten nu producten. |
> | `GET /products/{id}`, `GET /access_passes/{id}` | `GET /products/{id}` | |
> | `POST /products/{id}`, `POST /access_passes/{id}` | `PATCH /products/{id}` | |
> | `GET /plans` | `GET /variants` | |
> | `GET /plans/{id}` | `GET /variants/{id}` | |
> | `POST /plans` | `POST /variants` | |
> | `POST /plans/{id}` | `PATCH /variants/{id}` | |
> | `POST /plans/{id}/create_quick_link` | `POST /variants` | Maak een variant aan met `visibility: "quick_link"`, `stock` en `short_link`. De Current API kopieert geen bestaand plan, dus stuur ook de prijsvelden ervan mee. |
> | `GET /promo_codes` | `GET /promo_codes` | |
> | `GET /promo_codes/{id}` | `GET /promo_codes/{id}` | |
> | `POST /promo_codes` | `POST /promo_codes` | |
> | `POST /promo_codes/{id}` | `POST /promo_codes/{id}/activate`, `POST /promo_codes/{id}/deactivate` | Dekt alleen `status`. Maak een nieuwe promotiecode aan om de varianten, voorraad of metadata te wijzigen. Deactiveer daarna de oude. |
> | `DELETE /promo_codes/{id}` | `DELETE /promo_codes/{id}` | |
>
> #### Account, experiences, reviews en webhooks
>
> | v2-route | Current API | Opmerkingen |
> | - | - | - |
> | `GET /company` | `GET /accounts/me` | |
> | `GET /experiences` | `GET /experiences` | |
> | `GET /experiences/{id}` | `GET /experiences/{id}` | |
> | `POST /experiences/{id}` | `PATCH /experiences/{id}` | |
> | `DELETE /experiences/{id}` | `DELETE /experiences/{id}` | |
> | `GET /reviews` | `GET /reviews` | |
> | `GET /reviews/{id}` | `GET /reviews/{id}` | |
> | `GET /webhooks` | `GET /webhooks` | |
> | `GET /webhooks/{id}` | `GET /webhooks/{id}` | |
> | `POST /webhooks` | `POST /webhooks` | Zie [Webhooks](#webhooks). |
> | `POST /webhooks/{id}` | `PATCH /webhooks/{id}` | |
> | `DELETE /webhooks/{id}` | `DELETE /webhooks/{id}` | |
>
> ### Wat er is veranderd ten opzichte van v2
>
> #### Gedeeltelijke updates
>
> v2 werkte een resource bij met `POST /resource/{id}`. De Current API gebruikt `PATCH /resource/{id}` en wijzigt alleen de velden die je meestuurt.
>
> #### Licentiesleutels
>
> `validate_license` in v2 controleerde een sleutel en koppelde die in één aanroep aan een machine. In de Current API haalt je server het lidmaatschap op aan de hand van de licentiesleutel, controleert de `status` ervan en schrijft een hardware-ID naar `metadata` de eerste keer dat iemand de sleutel gebruikt. De [SaaS-gids](https://docs.whop.com/nl/supported-business-models/saas.md#license-key-integration) bevat het volledige voorbeeld.
>
> Houd deze aanroepen op je server. Met de API-sleutel van je account kun je elk lidmaatschap in je bedrijf wijzigen, dus lever die nooit mee in downloadbare software.
>
> #### Webhooks in het v2-formaat
>
> Webhooks die via v2 zijn aangemaakt, blijven payloads in het v2-formaat versturen. Om het huidige formaat te ontvangen, maak je een nieuwe webhook aan vanuit het dashboard of met `POST /webhooks`, verplaats je je handler daarnaartoe en verwijder je daarna de v2-webhook. [Webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md) behandelt handtekeningcontroles en eventtypen.

> [tab] Public GraphQL
>
> ### Je GraphQL-aanroepen vinden
>
> Als je app `WhopServerSdk` of `makeWhopServerSdk` importeert uit `@whop/api`, roept die de GraphQL API aan. Elke methode op die client, zoals `whopSdk.access.checkIfUserHasAccessToExperience`, verstuurt een GraphQL-bewerking met dezelfde naam.
>
> Elke GraphQL-respons bevat ook deze headers:
>
> | Header | Voorbeeld | Betekenis |
> | - | - | - |
> | `Deprecation` | `@1789948800` | Whop heeft deze API verouderd verklaard. De waarde is de datum van veroudering in Unix-seconden. |
> | `Sunset` | `Mon, 26 Oct 2026 00:00:00 GMT` | De GraphQL API werkt niet meer vanaf 26 oktober 2026. |
> | `Link` | `<https://docs.whop.com/developer/api/migrate-from-previous-versions#public-graphql>; rel="deprecation"` | Deze gids. |
>
> Zoek in je code naar `@whop/api`, of log responsen die `Deprecation` bevatten, om elke aanroep te vinden die je app nog doet.
>
> > [!NOTE]
> >
> > `verifyUserToken` uit `@whop/api` controleert de header `x-whop-user-token` lokaal en roept de GraphQL API nooit aan, dus die blijft werken na de uitfasering. [Authenticatie](https://docs.whop.com/nl/developer/guides/authentication.md) beschrijft hoe je het token in andere talen verifieert.
>
> ### Overzicht van bewerkingen
>
> #### Toegangscontroles
>
> De meeste apps roepen een van deze aan bij elke paginalading. Alle drie komen overeen met één endpoint dat de gebruikers-ID en de experience-, product- of account-ID accepteert.
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `checkIfUserHasAccessToExperience` | `GET /users/{id}/access/{resource_id}` | Geef een `exp_`-ID mee als `resource_id`. |
> | `checkIfUserHasAccessToAccessPass` | `GET /users/{id}/access/{resource_id}` | Geef een `prod_`-ID mee. Access passes heten nu producten. |
> | `checkIfUserHasAccessToCompany` | `GET /users/{id}/access/{resource_id}` | Geef een `biz_`-ID mee. |
>
> De respons bevat `has_access` en `access_level`, met de waarde `customer`, `admin` of `no_access`, dezelfde waarden als `hasAccess` en `accessLevel` in GraphQL.
>
> #### Chat en berichten
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `listMessagesFromChat` | `GET /messages` | Geef de ID van de chat-experience mee als `channel_id`. Zie [Stop met het pollen van chat](#stop-polling-chat). |
> | `sendMessageToChat` | `POST /messages` | Geef de ID van de chat-experience mee als `channel_id` en de tekst als `content`. |
> | `sendDirectMessageToUser` | `POST /channels`, daarna `POST /messages` | Maak het gesprek aan met `kind` ingesteld op `private` en de ontvanger in `participant_user_ids`, en stuur daarna naar de ID ervan als `channel_id`. |
> | `listDirectMessageConversations` | `GET /channels` | Geef `kind=private` mee. |
>
> #### Gebruikers
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `getUser` | `GET /users/{id}` | |
> | `getCurrentUser` | `GET /users/me` | Retourneert de gebruiker bij wie het token hoort. Lees met een app-API-sleutel de gebruikers-ID uit `verifyUserToken` en roep `GET /users/{id}` aan. |
> | `listUsersForExperience` | `GET /members` | Filter met `product_ids`. |
>
> #### Experiences en producten
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `getExperience` | `GET /experiences/{id}` | |
> | `listExperiences` | `GET /experiences` | Filter met `product_id` of `app_id`. |
> | `getAccessPass` | `GET /products/{id}` | |
> | `listAccessPasses` | `GET /products` | |
> | `listAccessPassesForExperience` | `GET /products` | |
> | `createAccessPass` | `POST /products` | |
> | `updateAccessPass` | `PATCH /products/{id}` | |
> | `deleteAccessPass` | `DELETE /products/{id}` | |
> | `listPlans` | `GET /variants` | Plannen heten nu varianten. Variant-ID's behouden de prefix `plan_`. |
>
> #### Je account
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `getCompany` | `GET /accounts/me` | Companies heten nu accounts. |
> | `listMemberships` | `GET /memberships` | |
> | `listMembers`, `getMember` | `GET /members`, `GET /members/{id}` | |
> | `listAuthorizedUsers` | `GET /authorized_users` | |
> | `listWaitlistEntries` | `GET /waitlist_entries` | |
> | `listReceiptsForCompany` | `GET /payments` | |
>
> #### Betalingen
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `chargeUser` | `POST /payments` | |
> | `createCheckoutSession` | `POST /checkout_configurations` | Checkoutsessies heten nu checkoutconfiguraties. De respons bevat `purchase_url`. |
> | `payUser` | `POST /transfers` | |
> | `listInvoices`, `getInvoice`, `createInvoice` | `GET /invoices`, `GET /invoices/{id}`, `POST /invoices` | |
> | `listPromoCodes`, `createPromoCode` | `GET /promo_codes`, `POST /promo_codes` | |
> | `listAffiliates`, `createAffiliate` | `GET /affiliates`, `POST /affiliates` | |
>
> #### Bestanden en meldingen
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `uploadMedia`, `processAttachment` | `POST /files`, daarna `POST /files/{id}/complete` | |
> | `getAttachment` | `GET /files/{id}` | |
> | `sendPushNotification` | `POST /notifications` | Target een `experience_id` of een lijst met `user_ids`. |
>
> #### Cursussen en forums
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `listCoursesForExperience` | `GET /courses` | Filter met `experience_id`. |
> | `listCoursesForCompany` | `GET /courses` | Filter met `account_id`. |
> | `getCourse` | `GET /courses/{id}` | |
> | `getLesson` | `GET /course_lessons/{id}` | |
> | `getUserLessonInteractions` | `GET /course_lesson_interactions` | Filter met `user_id`, `lesson_id` of `course_id`. |
> | `markLessonAsCompleted` | `POST /course_lessons/{lesson_id}/mark_as_completed` | |
> | `listForumPostsFromForum` | `GET /forum_posts` | Filter met `experience_id`. |
> | `createForumPost` | `POST /forum_posts` | |
>
> #### Webhookbewerkingen
>
> | GraphQL-bewerking | Current API | Opmerkingen |
> | - | - | - |
> | `listWebhooks`, `getWebhook` | `GET /webhooks`, `GET /webhooks/{id}` | |
> | `createWebhook` | `POST /webhooks` | |
> | `updateWebhook` | `PATCH /webhooks/{id}` | |
> | `deleteWebhook` | `DELETE /webhooks/{id}` | |
> | `testWebhook` | `POST /webhooks/{id}/test` | |
>
> Staat een bewerking die je app gebruikt er niet tussen, zoek de resource dan op in de [API-referentie](https://docs.whop.com/nl/api-reference.md), of neem contact op met support en vermeld de naam van de bewerking.
>
> ### Gedragswijzigingen
>
> #### Stop met het pollen van chat
>
> Apps die op chatberichten reageren, riepen `listMessagesFromChat` vaak op een timer aan. Abonneer je in plaats daarvan op de webhook `chat.message.created`: Whop stuurt elk nieuw bericht naar je server zodra het is geplaatst, dus je hoeft niet te pollen. Gebruik `GET /messages` alleen om de geschiedenis te laden.
>
> #### Veldnamen
>
> Velden in de Current API gebruiken `snake_case` (`has_access`, `access_level`), waar GraphQL `camelCase` gebruikte (`hasAccess`, `accessLevel`). Resource-ID's behouden hun prefixen, dus ID's die je hebt opgeslagen blijven werken.

## Paginering

v2 pagineerde met `page` en `per` en retourneerde `pagination.current_page` en `pagination.total_page`. Lijsten in de Current API retourneren een `data`-array en een `page_info`-object. Geef `first` mee om de paginagrootte in te stellen en `after` met de vorige `page_info.end_cursor` om de volgende pagina op te halen. Stop wanneer `page_info.has_next_page` `false` is. De SDK's pagineren voor je.

```typescript TypeScript theme={null}
for await (const membership of client.memberships.list({ product_id: "prod_xxxxxxxxxxxxx" })) {
  console.log(membership.id);
}
```

```python Python theme={null}
for membership in client.memberships.list(product_id="prod_xxxxxxxxxxxxx"):
    print(membership.id)
```

## Volgende stappen

> [card] [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
>
> Pin een versie zodat latere wijzigingen je integratie nooit breken.

> [card] [Webhooks](https://docs.whop.com/nl/developer/guides/webhooks.md)
>
> Verifieer handtekeningen, verwerk het huidige eventformaat en ontvang chatberichten in plaats van te pollen.

> [card] [Lidmaatschappen beheren](https://docs.whop.com/nl/developer/guides/memberships.md)
>
> Annuleer, pauzeer, verleng en werk lidmaatschappen bij.

> [card] [App-weergaven](https://docs.whop.com/nl/developer/guides/app-views.md)
>
> Controleer de toegang van leden in experience- en dashboardweergaven.


## Related topics

- [Overzicht van de Whop API](https://docs.whop.com/nl/api-reference/overview.md)
- [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
- [Migreren van legacy-facturen](https://docs.whop.com/nl/developer/guides/migrate-from-legacy-invoices.md)
