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

# Team Members API

> Een Team Member is een lid van het team van een account: de koppeling tussen een gebruiker en een account, met de rol die bepaalt wat diegene mag doen.

Rollen zijn systeemrollen (zoals `admin` of `moderator`) of `custom`-rollen die vanuit het dashboard worden beheerd.

Gebruik de Team Members API om het team van een account weer te geven, een gebruiker met een systeemrol aan het team toe te voegen, de rol van een lid te wijzigen en leden te verwijderen. Als je een gebruiker toevoegt die nog niet heeft geaccepteerd, wordt in plaats daarvan een uitnodiging verstuurd.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Team Members weergeven](https://docs.whop.com/nl/api-reference/team-members/list-team-members.md) | GET `/team_members` |
| [Team Member ophalen](https://docs.whop.com/nl/api-reference/team-members/retrieve-team-member.md) | GET `/team_members/{id}` |
| [Team Member aanmaken](https://docs.whop.com/nl/api-reference/team-members/create-team-member.md) | POST `/team_members` |
| [Team Member bijwerken](https://docs.whop.com/nl/api-reference/team-members/update-team-member.md) | PATCH `/team_members/{id}` |
| [Team Member verwijderen](https://docs.whop.com/nl/api-reference/team-members/delete-team-member.md) | DELETE `/team_members/{id}` |

## Attributen

**id** `string` *required*

Teamlid-ID. Geaccepteerde leden hebben een ID dat begint met `ausr_` of
`mber_`, en openstaande uitnodigingen een ID dat begint met `ausri_`. Behandel
het als ondoorzichtig: beide ledenprefixen worden geaccepteerd overal waar een
teamlid-ID wordt geaccepteerd.

**account** `object` *required*

Het account waartoe dit lidmaatschap behoort.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **fees** `object`
>
> Opslagtarieven die dit bovenliggende account in rekening brengt bij het
> subaccount dat wordt gelezen, per kostentype (bijvoorbeeld
> `crypto_deposit_markup`), elk met `percentage_fee` en `fixed_fee_usd`. Bepaald
> waarbij de eigen overschrijvingen van het subaccount voorrang krijgen op de
> standaardwaarde van het platform.
>
> **logo\_url** `string | null` *required*
>
> URL van de logo-afbeelding van het account.
>
> **route** `string` *required*
>
> Openbare route-identificatie van het account.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

**authorized\_role** `object | null` *required*

Aangepaste rol die aan dit lid is toegewezen, of `null` als het lid een systeemrol heeft.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> ID van de aangepaste rol, met prefix `aurl_`.
>
> **name** `string` *required*
>
> Naam van de aangepaste rol.

**created\_at** `string` *required*

Wanneer het lid zich bij het team aansloot of de uitnodiging werd verstuurd,
als ISO 8601-tijdstempel. Een lid dat eerst klant was, behoudt de datum
waarop de rol werd toegekend.

**direct\_reports\_count** `integer | null` *required*

Hoeveel teamleden rechtstreeks aan dit lid rapporteren. `null` voor
uitnodigingen.

**email** `string | null` *required*

Het e-mailadres van het lid. Voor een uitnodiging aan een e-mailadres zonder
Whop-account is dit het uitgenodigde adres. Anders is het `null`, tenzij de
aanroeper de scope `company:authorized_user:email:read` heeft.

**is\_agent** `boolean` *required*

Of dit lid een agent is (een door een app beheerd account) in plaats van een
menselijk teamlid. Altijd `false` voor uitnodigingen.

**is\_partner** `boolean` *required*

Of dit lid of deze uitnodiging de alleen-lezen Partner-rol heeft, rechtstreeks
of via een aangepaste rol die daarop is gebaseerd. Een Partner kan alleen de
basisgegevens van het account lezen.

**reports\_to\_chain** `object[] | null` *required*

De managers boven dit lid, dichtstbijzijnde eerst: het lid aan wie diegene rapporteert, dan de manager van dat lid, tot aan de top van de rapportagelijn. `[]` als het lid rechtstreeks aan het bedrijf rapporteert. Een aanroeper die alleen de eigen rapportagelijn mag lezen, ziet deze bij zichzelf eindigen, en `null` waar die niet voor hem leesbaar is. `null` voor uitnodigingen.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Het teamlid-ID van de manager, beginnend met `ausr_` of `mber_`; behandel het
> als ondoorzichtig.
>
> **user** `object` *required*
>
> De gebruiker achter het teamlidmaatschap van de manager.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Gebruikers-ID, met prefix `user_`.
> >
> > **name** `string | null` *required*
> >
> > Weergavenaam.
> >
> > **profile\_picture** `object` *required*
> >
> > Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder als de gebruiker geen foto heeft ingesteld.
> >
> > > [accordion] Eigenschappen
> > >
> > > **url** `string` *required*
> > >
> > > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder als de gebruiker geen foto heeft ingesteld.
> >
> > **username** `string` *required*
> >
> > Openbare gebruikersnaam.

**reports\_to\_id** `string | null` *required*

Het ID van het teamlid aan wie dit lid rapporteert, beginnend met `ausr_` of
`mber_`; behandel het als ondoorzichtig. `null` als het lid rechtstreeks aan
het bedrijf rapporteert, en voor uitnodigingen.

**role** `string` *required*

De rol van het lid binnen het account. `custom` betekent een op maat gemaakte rol die in het dashboard wordt beheerd; de API kan deze lezen maar niet toekennen.

Beschikbare opties: `owner`, `admin`, `partner`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `workforce`, `custom`

**status** `string` *required*

`joined` voor geaccepteerde leden, `pending` zolang de uitnodiging openstaat.

Beschikbare opties: `joined`, `pending`

**updated\_at** `string` *required*

Wanneer het lidmaatschap voor het laatst is bijgewerkt, als ISO
8601-tijdstempel.

**user** `object | null` *required*

De gebruiker achter dit teamlidmaatschap. `null` voor een uitnodiging die is verstuurd naar een e-mailadres zonder Whop-account.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Gebruikers-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder als de gebruiker geen foto heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder als de gebruiker geen foto heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

```json TeamMember theme={null}
{
	"id": "ausr_xxxxxxxxxxxxx",
	"status": "joined",
	"role": "admin",
	"authorized_role": null,
	"is_agent": false,
	"is_partner": false,
	"account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://cdn.whop.com/logo.png"
	},
	"email": "jane@example.com",
	"created_at": "2026-07-01T00:00:00.000Z",
	"updated_at": "2026-07-01T00:00:00.000Z",
	"reports_to_id": "ausr_xxxxxxxxxxxxy",
	"direct_reports_count": 0,
	"reports_to_chain": [
		{
			"id": "ausr_xxxxxxxxxxxxy",
			"user": {
				"id": "user_xxxxxxxxxxxy",
				"name": "Sam Lee",
				"profile_picture": {
					"url": "https://cdn.whop.com/manager.png"
				},
				"username": "samlee"
			}
		}
	],
	"user": {
		"id": "user_xxxxxxxxxxxx",
		"name": "Jane Doe",
		"profile_picture": {
			"url": "https://cdn.whop.com/user.png"
		},
		"username": "janedoe"
	}
}
```


## Related topics

- [Permissions API](https://docs.whop.com/nl/api-reference/permissions/permission.md)
- [Update Team Member](https://docs.whop.com/nl/api-reference/team-members/update-team-member.md)
- [List Team Members](https://docs.whop.com/nl/api-reference/team-members/list-team-members.md)
