> ## 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 de Team Members

> Un Team Member es un miembro del equipo de una cuenta: el vínculo entre un usuario y una cuenta, con el rol que controla lo que puede hacer.

Los roles son roles de sistema (como `admin` o `moderator`) o roles `custom` que se gestionan desde el panel.

Usa la API de Team Members para listar el equipo de una cuenta, añadir un usuario al equipo con un rol de sistema, cambiar el rol de un miembro y eliminar miembros. Añadir un usuario que todavía no ha aceptado envía una invitación en su lugar.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Team Members](https://docs.whop.com/es/api-reference/team-members/list-team-members.md) | GET `/team_members` |
| [Obtener Team Member](https://docs.whop.com/es/api-reference/team-members/retrieve-team-member.md) | GET `/team_members/{id}` |
| [Crear Team Member](https://docs.whop.com/es/api-reference/team-members/create-team-member.md) | POST `/team_members` |
| [Actualizar Team Member](https://docs.whop.com/es/api-reference/team-members/update-team-member.md) | PATCH `/team_members/{id}` |
| [Eliminar Team Member](https://docs.whop.com/es/api-reference/team-members/delete-team-member.md) | DELETE `/team_members/{id}` |

## Atributos

**id** `string` *required*

ID del miembro del equipo. Los miembros aceptados tienen un ID que empieza por `ausr_` o `mber_`,
y las invitaciones pendientes uno que empieza por `ausri_`. Trátalo como opaco: ambos
prefijos de miembro se aceptan en cualquier lugar donde se acepte un ID de miembro del equipo.

**account** `object` *required*

La cuenta a la que pertenece esta membresía.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **fees** `object`
>
> Tasas de recargo que esta cuenta principal cobra a la subcuenta que se está leyendo, indexadas por tipo de comisión
> (por ejemplo `crypto_deposit_markup`), cada una con `percentage_fee` y
> `fixed_fee_usd`. Se resuelven dando prioridad a las anulaciones propias de la subcuenta sobre el
> valor predeterminado de la plataforma.
>
> **logo\_url** `string | null` *required*
>
> URL de la imagen del logo de la cuenta.
>
> **route** `string` *required*
>
> Identificador de la ruta pública de la cuenta.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

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

Rol personalizado asignado a este miembro, o `null` cuando el miembro tiene un rol de sistema.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del rol personalizado, con el prefijo `aurl_`.
>
> **name** `string` *required*
>
> Nombre del rol personalizado.

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

Cuándo se unió el miembro al equipo o se envió la invitación, como marca de tiempo ISO 8601.
Un miembro que primero fue cliente conserva la fecha en que se le asignó
su rol.

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

Cuántos miembros del equipo dependen directamente de este miembro. `null` para invitaciones.

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

La dirección de correo electrónico del miembro. Para una invitación a un correo electrónico que todavía no tiene cuenta de Whop,
es la dirección invitada. En otro caso, es `null` a menos que quien llama
tenga el scope `company:authorized_user:email:read`.

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

Si este miembro es un agente (una cuenta controlada por una app) en lugar de un miembro
humano del equipo. Siempre `false` para invitaciones.

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

Si este miembro o invitación tiene el rol Partner de solo lectura, directamente o
a través de un rol personalizado basado en él. Un Partner solo puede leer los datos básicos
de la cuenta.

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

Los responsables por encima de este miembro, del más cercano al más lejano: el miembro del que depende, luego el responsable de ese miembro, hasta lo más alto de la línea jerárquica. `[]` cuando el miembro depende directamente del negocio. Quien llama y solo puede leer su propia línea jerárquica la ve terminar en sí mismo, y `null` donde no puede leerla. `null` para invitaciones.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID de miembro del equipo del responsable, que empieza por `ausr_` o `mber_`; trátalo como
> opaco.
>
> **user** `object` *required*
>
> El usuario detrás de la membresía de equipo del responsable.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID de usuario, con el prefijo `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nombre visible.
> >
> > **profile\_picture** `object` *required*
> >
> > Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no definió ninguna imagen.
> >
> > > [accordion] Propiedades
> > >
> > > **url** `string` *required*
> > >
> > > URL de la imagen del avatar. Siempre está presente. Es un marcador de posición generado cuando el usuario no definió ninguna imagen.
> >
> > **username** `string` *required*
> >
> > Nombre de usuario público.

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

El ID del miembro del equipo del que depende este miembro, que empieza por `ausr_` o
`mber_`; trátalo como opaco. `null` cuando el miembro depende directamente del
negocio, y para invitaciones.

**role** `string` *required*

El rol del miembro en la cuenta. `custom` significa un rol a medida gestionado desde el panel; la API puede leerlo pero no otorgarlo.

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

**status** `string` *required*

`joined` para miembros aceptados, `pending` mientras la invitación está pendiente.

Opciones disponibles: `joined`, `pending`

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

Cuándo se actualizó la membresía por última vez, como marca de tiempo ISO 8601.

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

El usuario detrás de esta membresía de equipo. `null` para una invitación enviada a un correo electrónico que todavía no tiene cuenta de Whop.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de usuario, con el prefijo `user_`.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no definió ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre está presente. Es un marcador de posición generado cuando el usuario no definió ninguna imagen.
>
> **username** `string` *required*
>
> Nombre de usuario público.

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