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

> Een app is een integratie die op Whop is gebouwd. Apps kunnen consumenten bedienen als experiences binnen producten, of bedrijven bedienen als zakelijke tools.

> [!NOTE]
>
> Deze resource heeft een opvolger in de [Current API](https://docs.whop.com/nl/api-reference/legacy/apps/app.md), de API met versies waarop nieuwe integraties moeten bouwen. Deze pagina blijft volledig ondersteund.

```json Example theme={null}
{
	"api_key": {
		"created_at": "2023-12-01T05:00:00.401Z",
		"id": "<string>",
		"token": "<string>"
	},
	"app_type": "b2b_app",
	"base_url": "https://myapp.example.com",
	"company": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Pickaxe"
	},
	"creator": {
		"id": "user_xxxxxxxxxxxxx",
		"name": "John Doe",
		"username": "johndoe42"
	},
	"dashboard_path": "/experiences/[experienceId]",
	"default_api_key": {
		"id": "<string>",
		"name": "<string>",
		"obfuscated_secret_key": "<string>",
		"secret_key": "<string>"
	},
	"description": "A comprehensive analytics dashboard for tracking revenue, members, and growth metrics.",
	"discover_path": "/experiences/[experienceId]",
	"domain_id": "ab1c2d3e4f5g6h7i8j9k",
	"experience_path": "/experiences/[experienceId]",
	"hosted_url": "https://myapp.whop.site",
	"icon": {
		"url": "https://media.whop.com/abc123/optimized.jpg"
	},
	"id": "app_xxxxxxxxxxxxxx",
	"marketplace_status": "not_available",
	"name": "Courses",
	"oauth_client_type": "public",
	"openapi_path": "/experiences/[experienceId]",
	"origin": "<string>",
	"product_id": "<string>",
	"production_web_build": {
		"checksum": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
		"file_url": "https://cdn.whop.com/builds/abc123.zip",
		"id": "apbu_xxxxxxxxxxxxx",
		"source_url": "https://cdn.whop.com/builds/abc123-source.zip",
		"status": "draft"
	},
	"redirect_uris": ["<string>"],
	"requested_permissions": [
		{
			"is_required": true,
			"justification": "<string>",
			"permission_action": {
				"action": "<string>",
				"name": "<string>"
			}
		}
	],
	"route": "myapp",
	"secrets": {},
	"skills_path": "/experiences/[experienceId]",
	"stats": {
		"dau": 42,
		"mau": 42,
		"time_spent_last24_hours": 42,
		"wau": 42
	},
	"status": "live",
	"verified": true
}
```

**api\_key** `object | null` *required*

De API-sleutel die wordt gebruikt om verzoeken namens deze app te authenticeren. Null als er geen API-sleutel is gegenereerd. Vereist de machtiging 'developer:manage\_api\_key'.

**onderliggende attributen**

**created\_at** `string\<date-time\>` *required*

De datum en tijd waarop de privé-API-sleutel is aangemaakt.

Voorbeeld: `2023-12-01T05:00:00.401Z`

**id** `string` *required*

De unieke identificatie van de privé-API-sleutel.

**token** `string` *required*

Dit is de API-sleutel die wordt gebruikt om verzoeken te authenticeren

**app\_type** `AppTypes` *required*

De classificatie van de doelgroep voor deze app (bijv. 'b2b\_app', 'b2c\_app', 'company\_app', 'component').

Beschikbare opties: `b2b_app`, `b2c_app`, `company_app`, `component`, `website`

**base\_url** `string | null` *required*

De productie-basis-URL waar de app wordt gehost. `null` als er geen basis-URL is geconfigureerd, of als de aanroeper niet de machtiging `developer:basic:read` heeft op het account van de app.

Voorbeeld: `https://myapp.example.com`

**company** `object` *required*

Het bedrijf dat eigenaar is van deze app en deze publiceert.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van het bedrijf.

Voorbeeld: `biz_xxxxxxxxxxxxxx`

**title** `string` *required*

De weergavenaam van het bedrijf die aan klanten wordt getoond.

Voorbeeld: `Pickaxe`

**creator** `object` *required*

De gebruiker die het bedrijf heeft aangemaakt en bezit dat deze app heeft gepubliceerd.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van de gebruiker.

Voorbeeld: `user_xxxxxxxxxxxxx`

**name** `string | null` *required*

De weergavenaam van de gebruiker die op het openbare profiel wordt getoond.

Voorbeeld: `John Doe`

**username** `string` *required*

De unieke gebruikersnaam van de gebruiker die op het openbare profiel wordt getoond.

Voorbeeld: `johndoe42`

**dashboard\_path** `string | null` *required*

Het URL-padsjabloon voor een specifieke weergave van deze app, toegevoegd aan het basisdomein (bijv. '/experiences/\[experienceId]'). Null als het opgegeven weergavetype niet is geconfigureerd.

Voorbeeld: `/experiences/[experienceId]`

**default\_api\_key** `object | null` *required*

De standaard-API-sleutel van de app, gebruikt om verzoeken namens deze app te authenticeren. Null als de app geen standaardsleutel heeft. Vereist de machtiging 'developer:manage\_api\_key'.

**onderliggende attributen**

**id** `string` *required*

De unieke identificatie van de geautoriseerde API-sleutel.

**name** `string | null` *required*

Een door de gebruiker ingestelde naam om een API-sleutel te herkennen

**obfuscated\_secret\_key** `string` *required*

Een gemaskeerde versie van de geheime sleutel die wordt gebruikt om verzoeken te authenticeren. Zo kan de eigenaar gemakkelijk zien om welke sleutel het gaat zonder dat het volledige geheim wordt getoond.

**secret\_key** `string | null` *required*

De geheime sleutel die wordt gebruikt om verzoeken te authenticeren. Deze is alleen beschikbaar als de huidige actor deze API-sleutel had kunnen aanmaken.

**description** `string | null` *required*

Een geschreven beschrijving van wat deze app doet, weergegeven op de vermeldingspagina in de app store. Null als er geen beschrijving is ingesteld.

Voorbeeld: `A comprehensive analytics dashboard for tracking revenue,…`

**discover\_path** `string | null` *required*

Het URL-padsjabloon voor een specifieke weergave van deze app, toegevoegd aan het basisdomein (bijv. '/experiences/\[experienceId]'). Null als het opgegeven weergavetype niet is geconfigureerd.

Voorbeeld: `/experiences/[experienceId]`

**domain\_id** `string` *required*

De unieke subdomeinidentificatie voor de geproxyde URL van deze app op het Whop-platform. Vormt het URL-patroon https\://\{domain\_id}.apps.whop.com.

Voorbeeld: `ab1c2d3e4f5g6h7i8j9k`

**experience\_path** `string | null` *required*

Het URL-padsjabloon voor een specifieke weergave van deze app, toegevoegd aan het basisdomein (bijv. '/experiences/\[experienceId]'). Null als het opgegeven weergavetype niet is geconfigureerd.

Voorbeeld: `/experiences/[experienceId]`

**hosted\_url** `string | null` *required*

De volledige canonieke URL waar de gehoste webbuild van deze app wordt geleverd. Null als de app geen route heeft geclaimd.

Voorbeeld: `https://myapp.whop.site`

**icon** `object | null` *required*

De pictogramafbeelding van deze app, weergegeven in de app store, op productpagina's, bij checkout en als standaardpictogram voor experiences die deze app gebruiken.

**onderliggende attributen**

**url** `string | null` *required*

Een vooraf geoptimaliseerde URL om deze bijlage op de client te renderen. Deze moet worden gebruikt om bijlagen in apps weer te geven.

Voorbeeld: `https://media.whop.com/abc123/optimized.jpg`

**id** `string` *required*

De unieke identificatie van de app.

Voorbeeld: `app_xxxxxxxxxxxxxx`

**marketplace\_status** `MarketplaceStatuses | null` *required*

De goedkeuringsstatus van de productvermelding van deze app in de Whop app store. Null als de app geen gekoppeld product heeft.

Beschikbare opties: `not_available`, `pending_review`, `live_marketplace`

**name** `string` *required*

De weergavenaam van deze app in de app store en in de navigatie van experiences. Maximaal 30 tekens.

Voorbeeld: `Courses`

**oauth\_client\_type** `AppOauthClientTypes` *required*

Hoe deze app zich authenticeert bij het uitwisselen van OAuth-autorisatie- en refresh-grants.

Beschikbare opties: `public`, `confidential`

**openapi\_path** `string | null` *required*

Het URL-padsjabloon voor een specifieke weergave van deze app, toegevoegd aan het basisdomein (bijv. '/experiences/\[experienceId]'). Null als het opgegeven weergavetype niet is geconfigureerd.

Voorbeeld: `/experiences/[experienceId]`

**origin** `string | null` *required*

De volledige origin-URL voor het geproxyde domein van deze app (bijv. '[https://myapp.apps.whop.com](https://myapp.apps.whop.com)'). Null als er geen proxydomein is geconfigureerd.

**product\_id** `string | null` *required*

**production\_web\_build** `object | null` *required*

De goedgekeurde app-build die momenteel op het web aan gebruikers wordt geleverd. Null als er geen productiebuild voor het web is geïmplementeerd.

**onderliggende attributen**

**checksum** `string` *required*

Een SHA-256-hash van het geüploade buildbestand, gegenereerd door de client en gebruikt om de bestandsintegriteit te verifiëren.

Voorbeeld: `e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7…`

**file\_url** `string` *required*

Een URL om de app-build te downloaden als .zip-archief.

Voorbeeld: `https://cdn.whop.com/builds/abc123.zip`

**id** `string` *required*

De unieke identificatie van de app-build.

Voorbeeld: `apbu_xxxxxxxxxxxxx`

**source\_url** `string | null` *required*

Een URL om het gecomprimeerde broncodearchief te downloaden waaruit deze build is gemaakt. Null als de build zonder bronarchief is geüpload.

Voorbeeld: `https://cdn.whop.com/builds/abc123-source.zip`

**status** `AppBuildStatuses` *required*

De huidige beoordelingsstatus van deze build.

Beschikbare opties: `draft`, `pending`, `approved`, `rejected`

**redirect\_uris** `array\<string\>` *required*

De op de whitelist geplaatste OAuth-callback-URL's waarnaar gebruikers worden doorgestuurd nadat ze de app hebben geautoriseerd.

**requested\_permissions** `array\<object\>` *required*

De lijst met machtigingen die deze app aanvraagt bij installatie, inclusief zowel vereiste als optionele machtigingen met onderbouwing.

**onderliggende attributen**

**is\_required** `boolean` *required*

Of de actie vereist is om de app te laten functioneren.

**justification** `string` *required*

De reden voor het aanvragen van de actie.

**permission\_action** `object` *required*

De actie die de app van gebruikers zal aanvragen wanneer een gebruiker de app installeert.

**onderliggende attributen**

**action** `string` *required*

De identificatie van de actie.

**name** `string` *required*

De leesbare naam van de actie.

**route** `string | null` *required*

De unieke subdomeinroute waar de gehoste webbuilds van deze app worden geleverd, zoals 'myapp' voor myapp.whop.site. Null als de app geen route heeft geclaimd.

Voorbeeld: `myapp`

**secrets** `object | null` *required*

De secrets van de app als object met stringwaarden. Versleuteld opgeslagen en als omgevingsbindingen geïnjecteerd in de gehoste serverruntime van de app. Vereist de machtiging 'developer:update\_app'.

**skills\_path** `string | null` *required*

Het URL-padsjabloon voor een specifieke weergave van deze app, toegevoegd aan het basisdomein (bijv. '/experiences/\[experienceId]'). Null als het opgegeven weergavetype niet is geconfigureerd.

Voorbeeld: `/experiences/[experienceId]`

**stats** `object | null` *required*

Geaggregeerde gebruiksstatistieken voor deze app, inclusief dagelijkse, wekelijkse en maandelijkse aantallen actieve gebruikers.

**onderliggende attributen**

**dau** `integer` *required*

Het aantal unieke gebruikers dat in de afgelopen 24 uur tijd in deze app heeft doorgebracht. Retourneert 0 als er geen gebruiksgegevens beschikbaar zijn.

Voorbeeld: `42`

**mau** `integer` *required*

Het aantal unieke gebruikers dat in de afgelopen 28 dagen tijd in deze app heeft doorgebracht. Retourneert 0 als er geen gebruiksgegevens beschikbaar zijn.

Voorbeeld: `42`

**time\_spent\_last24\_hours** `integer` *required*

De totale tijd, in seconden, die alle gebruikers in de afgelopen 24 uur in deze app hebben doorgebracht. Retourneert 0 als er geen gebruiksgegevens beschikbaar zijn.

Voorbeeld: `42`

**wau** `integer` *required*

Het aantal unieke gebruikers dat in de afgelopen 7 dagen tijd in deze app heeft doorgebracht. Retourneert 0 als er geen gebruiksgegevens beschikbaar zijn.

Voorbeeld: `42`

**status** `AppStatuses` *required*

De huidige zichtbaarheidsstatus van deze app in de Whop app store. 'live' betekent openbaar vindbaar, 'unlisted' betekent alleen toegankelijk via een directe link, en 'hidden' betekent nergens zichtbaar.

Beschikbare opties: `live`, `unlisted`, `hidden`

**verified** `boolean` *required*

Of deze app door Whop is geverifieerd. Geverifieerde apps worden door Whop aanbevolen en weergegeven in de sectie met uitgelichte apps van de app store.


## Related topics

- [Apps API](https://docs.whop.com/nl/api-reference/apps/app.md)
- [App-installaties](https://docs.whop.com/nl/developer/guides/app-installations.md)
- [App-weergaven](https://docs.whop.com/nl/developer/guides/app-views.md)
