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

# API Team Members

> Un Team Member est un membre de l'équipe d'un compte : le lien entre un utilisateur et un compte, portant le rôle qui détermine ce qu'il peut faire.

Les rôles sont soit des rôles système (comme `admin` ou `moderator`), soit des rôles `custom` gérés depuis le tableau de bord.

Utilisez l'API Team Members pour lister l'équipe d'un compte, ajouter un utilisateur à l'équipe avec un rôle système, modifier le rôle d'un membre et retirer des membres. L'ajout d'un utilisateur qui n'a pas encore accepté envoie plutôt une invitation.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les membres de l'équipe](https://docs.whop.com/fr/api-reference/team-members/list-team-members.md) | GET `/team_members` |
| [Récupérer un membre de l'équipe](https://docs.whop.com/fr/api-reference/team-members/retrieve-team-member.md) | GET `/team_members/{id}` |
| [Créer un membre de l'équipe](https://docs.whop.com/fr/api-reference/team-members/create-team-member.md) | POST `/team_members` |
| [Mettre à jour un membre de l'équipe](https://docs.whop.com/fr/api-reference/team-members/update-team-member.md) | PATCH `/team_members/{id}` |
| [Supprimer un membre de l'équipe](https://docs.whop.com/fr/api-reference/team-members/delete-team-member.md) | DELETE `/team_members/{id}` |

## Attributs

**id** `string` *required*

ID du membre de l'équipe. Les membres ayant accepté ont un ID commençant par `ausr_` ou `mber_`, et les invitations en attente un ID commençant par `ausri_`. Traitez-le comme opaque : les deux préfixes de membre sont acceptés partout où un ID de membre de l'équipe l'est.

**account** `object` *required*

Le compte auquel appartient cette adhésion à l'équipe.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte, préfixé par `biz_`.
>
> **fees** `object`
>
> Taux de majoration que ce parent facture au sous-compte consulté, indexés par type de frais (par exemple `crypto_deposit_markup`), chacun avec `percentage_fee` et `fixed_fee_usd`. Résolus en donnant la priorité aux remplacements propres au sous-compte sur la valeur par défaut de la plateforme.
>
> **logo\_url** `string | null` *required*
>
> URL de l'image du logo du compte.
>
> **route** `string` *required*
>
> Identifiant de route publique du compte.
>
> **title** `string` *required*
>
> Nom d'affichage du compte.

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

Rôle personnalisé attribué à ce membre, ou `null` si le membre a un rôle système.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du rôle personnalisé, préfixé par `aurl_`.
>
> **name** `string` *required*
>
> Nom du rôle personnalisé.

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

Date à laquelle le membre a rejoint l'équipe ou l'invitation a été envoyée, sous forme d'horodatage ISO 8601. Un membre qui était d'abord client conserve la date à laquelle son rôle lui a été attribué.

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

Nombre de membres de l'équipe qui rendent compte directement à ce membre. `null` pour les invitations.

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

L'adresse e-mail du membre. Pour une invitation envoyée à une adresse e-mail qui n'a pas encore de compte Whop, il s'agit de l'adresse invitée. Sinon, la valeur est `null` sauf si l'appelant dispose du scope `company:authorized_user:email:read`.

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

Indique si ce membre est un agent (compte contrôlé par une app) plutôt qu'un membre humain de l'équipe. Toujours `false` pour les invitations.

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

Indique si ce membre ou cette invitation a le rôle Partner en lecture seule, directement ou via un rôle personnalisé basé sur celui-ci. Un Partner ne peut consulter que les informations de base du compte.

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

Les responsables au-dessus de ce membre, du plus proche au plus éloigné : le membre auquel il rend compte, puis le responsable de ce membre, jusqu'au sommet de la ligne hiérarchique. `[]` lorsque le membre rend compte directement à l'entreprise. Un appelant qui ne peut consulter que sa propre ligne hiérarchique la voit s'arrêter à lui-même, et `null` là où elle ne lui est pas lisible. `null` pour les invitations.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID de membre de l'équipe du responsable, commençant par `ausr_` ou `mber_` ; traitez-le comme opaque.
>
> **user** `object` *required*
>
> L'utilisateur derrière l'adhésion à l'équipe du responsable.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID utilisateur, préfixé par `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nom d'affichage.
> >
> > **profile\_picture** `object` *required*
> >
> > Conteneur de l'avatar. Son `url` est toujours présent et correspond à un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
> >
> > > [accordion] Propriétés
> > >
> > > **url** `string` *required*
> > >
> > > URL de l'image de l'avatar. Toujours présente. Il s'agit d'un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
> >
> > **username** `string` *required*
> >
> > Nom d'utilisateur public.

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

L'ID du membre de l'équipe auquel ce membre rend compte, commençant par `ausr_` ou `mber_` ; traitez-le comme opaque. `null` lorsque le membre rend compte directement à l'entreprise, ainsi que pour les invitations.

**role** `string` *required*

Le rôle du membre sur le compte. `custom` désigne un rôle sur mesure géré depuis le tableau de bord ; l'API peut le lire mais pas l'attribuer.

Options disponibles : `owner`, `admin`, `partner`, `sales_manager`, `moderator`, `advertiser`, `app_manager`, `support`, `manager`, `workforce`, `custom`

**status** `string` *required*

`joined` pour les membres ayant accepté, `pending` tant que l'invitation est en attente.

Options disponibles : `joined`, `pending`

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

Date de la dernière mise à jour de l'adhésion, sous forme d'horodatage ISO 8601.

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

L'utilisateur derrière cette adhésion à l'équipe. `null` pour une invitation envoyée à une adresse e-mail qui n'a pas encore de compte Whop.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID utilisateur, préfixé par `user_`.
>
> **name** `string | null` *required*
>
> Nom d'affichage.
>
> **profile\_picture** `object` *required*
>
> Conteneur de l'avatar. Son `url` est toujours présent et correspond à un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> > [accordion] Propriétés
> >
> > **url** `string` *required*
> >
> > URL de l'image de l'avatar. Toujours présente. Il s'agit d'un espace réservé généré lorsque l'utilisateur n'a défini aucune photo.
>
> **username** `string` *required*
>
> Nom d'utilisateur public.

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

- [Update Team Member](https://docs.whop.com/fr/api-reference/team-members/update-team-member.md)
- [List Team Members](https://docs.whop.com/fr/api-reference/team-members/list-team-members.md)
- [Delete Team Member](https://docs.whop.com/fr/api-reference/team-members/delete-team-member.md)
