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

> Una cuenta externa representa una cuenta en otra plataforma vinculada a una cuenta o usuario de Whop, como una página de Facebook, una cuenta de Instagram, una cuenta de TikTok o una cuenta de Klaviyo.

La conectas mediante OAuth o una clave de API, o Whop la crea por ti. Los ID de las cuentas externas llevan el prefijo `sacc_`.

Usa la API de cuentas externas para listar las cuentas conectadas, [conectar un perfil mediante OAuth](https://docs.whop.com/es/api-reference/external-accounts/connect-an-external-account.md), [crear una página de Facebook o una cuenta de TikTok gestionada por Whop, o conectar una cuenta de Klaviyo con su clave de API](https://docs.whop.com/es/api-reference/external-accounts/create-an-external-account.md), y desconectar una cuenta externa.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar cuentas externas](https://docs.whop.com/es/api-reference/external-accounts/list-external-accounts.md) | GET `/external_accounts` |
| [Crear una cuenta externa](https://docs.whop.com/es/api-reference/external-accounts/create-an-external-account.md) | POST `/external_accounts` |
| [Actualizar](https://docs.whop.com/es/api-reference/external-accounts/refresh.md) | POST `/external_accounts/{id}/refresh` |
| [Conectar una cuenta externa](https://docs.whop.com/es/api-reference/external-accounts/connect-an-external-account.md) | POST `/external_accounts/connect` |
| [Eliminar una cuenta externa](https://docs.whop.com/es/api-reference/external-accounts/delete-an-external-account.md) | DELETE `/external_accounts/{id}` |

## Atributos

**id** `string` *required*

Identificador único de la cuenta externa.

**error** `string | null` *required*

Por qué esta cuenta externa no se puede usar actualmente para publicidad: un uso compartido fallido o una restricción por parte de Meta. Null cuando la cuenta está en buen estado.

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

El ID específico de la plataforma para esta cuenta externa.

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

El nombre visible de la cuenta externa en la plataforma.

**parent\_external\_account** `object | null` *required*

La cuenta externa a la que pertenece esta en la plataforma, como la página de Facebook propietaria de una cuenta de Instagram. Null cuando la cuenta externa es independiente o cuando es un socio.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta externa, con el prefijo `sacc_`.
>
> **external\_id** `string | null` *required*
>
> El ID específico de la plataforma para la cuenta externa principal.
>
> **name** `string | null` *required*
>
> El nombre visible de la cuenta externa principal en la plataforma.
>
> **platform** `string` *required*
>
> La plataforma en la que existe la cuenta externa principal.
>
> Opciones disponibles: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`
>
> **profile\_picture\_url** `string | null` *required*
>
> La URL donde se puede acceder a la foto de perfil de la cuenta externa principal.
>
> **username** `string | null` *required*
>
> El nombre de usuario de la cuenta externa principal en la plataforma.
>
> **verified** `boolean` *required*
>
> Si la cuenta externa principal está verificada en la plataforma.

**partnership\_status** `string | null` *required*

Siempre `null`. Los anuncios de colaboración ya no están disponibles.

**platform** `string` *required*

La plataforma en la que existe la cuenta externa.

Opciones disponibles: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`

**profile\_picture\_url** `string | null` *required*

La URL donde se puede acceder a la foto de perfil de la cuenta externa.

**scopes** `string[]` *required*

Capacidades que Whop conserva específicas de esta cuenta externa. Por ejemplo, Whop puede solicitar la capacidad de publicar anuncios que usen la identidad de esta cuenta externa, reflejada por `advertise`. Las conexiones de perfiles personales no tienen ámbitos adicionales de Whop.

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

La URL donde se puede acceder a la cuenta externa en la plataforma. Null mientras una cuenta propiedad de Whop todavía se está aprovisionando.

**username** `string | null` *required*

El nombre de usuario de la cuenta externa en la plataforma. Null mientras una cuenta propiedad de Whop todavía se está aprovisionando, y en plataformas sin nombres de usuario, como Klaviyo.

**verified** `boolean` *required*

Si la cuenta externa está verificada en la plataforma.

```json ExternalAccount theme={null}
{
	"id": "sacc_xxxxxxxxxxxx",
	"external_id": "17841400000000000",
	"name": "Pickaxe Pro",
	"parent_external_account": {
		"id": "sacc_yyyyyyyyyyyy",
		"platform": "facebook",
		"username": "pickaxepro",
		"name": "Pickaxe Pro",
		"profile_picture_url": "https://img.whop.com/sacc_yyyyyyyyyyyy.png",
		"verified": true,
		"external_id": "112233445566778"
	},
	"platform": "instagram",
	"profile_picture_url": "https://img.whop.com/sacc_xxxxxxxxxxxx.png",
	"scopes": ["advertise"],
	"partnership_status": null,
	"error": null,
	"url": "https://instagram.com/pickaxepro",
	"username": "pickaxepro",
	"verified": true
}
```


## Related topics

- [Autenticación y claves de API](https://docs.whop.com/es/developer/guides/auth-scoping.md)
- [Enlace de cuenta](https://docs.whop.com/es/api-reference/legacy/account-links/account-link.md)
- [Versiones de la API](https://docs.whop.com/es/developer/api/versioning.md)
