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

> Un compte externe représente un compte sur une autre plateforme lié à un compte ou un utilisateur Whop, comme une page Facebook, un compte Instagram, un compte TikTok ou un compte Klaviyo.

Vous le connectez via OAuth ou une clé API, ou Whop le crée pour vous. Les ID de comptes externes sont préfixés par `sacc_`.

Utilisez l'API Comptes externes pour lister les comptes connectés, [connecter un profil via OAuth](https://docs.whop.com/fr/api-reference/external-accounts/connect-an-external-account.md), [créer une page Facebook ou un compte TikTok gérés par Whop, ou connecter un compte Klaviyo avec sa clé API](https://docs.whop.com/fr/api-reference/external-accounts/create-an-external-account.md), et déconnecter un compte externe.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les comptes externes](https://docs.whop.com/fr/api-reference/external-accounts/list-external-accounts.md) | GET `/external_accounts` |
| [Créer un compte externe](https://docs.whop.com/fr/api-reference/external-accounts/create-an-external-account.md) | POST `/external_accounts` |
| [Actualiser](https://docs.whop.com/fr/api-reference/external-accounts/refresh.md) | POST `/external_accounts/{id}/refresh` |
| [Connecter un compte externe](https://docs.whop.com/fr/api-reference/external-accounts/connect-an-external-account.md) | POST `/external_accounts/connect` |
| [Supprimer un compte externe](https://docs.whop.com/fr/api-reference/external-accounts/delete-an-external-account.md) | DELETE `/external_accounts/{id}` |

## Attributs

**id** `string` *required*

Identifiant unique du compte externe.

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

Raison pour laquelle ce compte externe ne peut actuellement pas être utilisé
pour la publicité — un partage échoué ou une restriction côté Meta. Null
lorsque le compte est en bon état.

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

L'ID propre à la plateforme pour ce compte externe.

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

Le nom d'affichage du compte externe sur la plateforme.

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

Le compte externe auquel celui-ci appartient sur la plateforme, comme la page Facebook qui possède un compte Instagram. Null lorsque le compte externe est autonome, ou lorsqu'il s'agit d'un partenaire.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> ID du compte externe, préfixé par `sacc_`.
>
> **external\_id** `string | null` *required*
>
> L'ID propre à la plateforme pour le compte externe parent.
>
> **name** `string | null` *required*
>
> Le nom d'affichage du compte externe parent sur la plateforme.
>
> **platform** `string` *required*
>
> La plateforme sur laquelle existe le compte externe parent.
>
> Options disponibles : `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`
>
> **profile\_picture\_url** `string | null` *required*
>
> L'URL à laquelle la photo de profil du compte externe parent est
> accessible.
>
> **username** `string | null` *required*
>
> Le nom d'utilisateur du compte externe parent sur la plateforme.
>
> **verified** `boolean` *required*
>
> Indique si le compte externe parent est vérifié sur la plateforme.

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

Toujours `null`. Les publicités en partenariat ne sont plus disponibles.

**platform** `string` *required*

La plateforme sur laquelle existe le compte externe.

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

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

L'URL à laquelle la photo de profil du compte externe est accessible.

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

Capacités que Whop conserve spécifiquement pour ce compte externe. Par exemple,
Whop peut demander la possibilité de diffuser des publicités utilisant
l'identité de ce compte externe, ce qui se traduit par `advertise`. Les
connexions de profils personnels n'ont aucun scope Whop supplémentaire.

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

L'URL à laquelle le compte externe est accessible sur la plateforme. Null
pendant qu'un compte appartenant à Whop est encore en cours de provisionnement.

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

Le nom d'utilisateur du compte externe sur la plateforme. Null pendant qu'un
compte appartenant à Whop est encore en cours de provisionnement, et sur les
plateformes sans noms d'utilisateur, comme Klaviyo.

**verified** `boolean` *required*

Indique si le compte externe est vérifié sur la plateforme.

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

- [API Payouts](https://docs.whop.com/fr/api-reference/payouts/payout.md)
- [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
- [Lien de compte](https://docs.whop.com/fr/api-reference/legacy/account-links/account-link.md)
