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

# External Accounts API

> Een External Account vertegenwoordigt een account op een ander platform dat is gekoppeld aan een Whop-account of -gebruiker, zoals een Facebook-pagina, Instagram-account, TikTok-account of Klaviyo-account.

Je koppelt het via OAuth of een API-sleutel, of Whop maakt het voor je aan. ID's van externe accounts hebben het voorvoegsel `sacc_`.

Gebruik de External Accounts API om gekoppelde accounts weer te geven, [een profiel te koppelen via OAuth](https://docs.whop.com/nl/api-reference/external-accounts/connect-an-external-account.md), [een door Whop beheerde Facebook-pagina of TikTok-account aan te maken, of een Klaviyo-account te koppelen met de API-sleutel](https://docs.whop.com/nl/api-reference/external-accounts/create-an-external-account.md), en een extern account te ontkoppelen.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [External Accounts weergeven](https://docs.whop.com/nl/api-reference/external-accounts/list-external-accounts.md) | GET `/external_accounts` |
| [Een External Account aanmaken](https://docs.whop.com/nl/api-reference/external-accounts/create-an-external-account.md) | POST `/external_accounts` |
| [Vernieuwen](https://docs.whop.com/nl/api-reference/external-accounts/refresh.md) | POST `/external_accounts/{id}/refresh` |
| [Een External Account koppelen](https://docs.whop.com/nl/api-reference/external-accounts/connect-an-external-account.md) | POST `/external_accounts/connect` |
| [Een External Account verwijderen](https://docs.whop.com/nl/api-reference/external-accounts/delete-an-external-account.md) | DELETE `/external_accounts/{id}` |

## Attributen

**id** `string` *required*

Unieke identificatie voor het externe account.

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

Waarom dit externe account momenteel niet voor adverteren kan worden gebruikt — een mislukte deling of een beperking aan de kant van Meta. Null wanneer het account in orde is.

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

De platformspecifieke ID van dit externe account.

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

De weergavenaam van het externe account op het platform.

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

Het externe account waartoe dit account op het platform behoort, zoals de Facebook-pagina die eigenaar is van een Instagram-account. Null wanneer het externe account op zichzelf staat, of wanneer het een partner is.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> ID van het externe account, met voorvoegsel `sacc_`.
>
> **external\_id** `string | null` *required*
>
> De platformspecifieke ID van het bovenliggende externe account.
>
> **name** `string | null` *required*
>
> De weergavenaam van het bovenliggende externe account op het platform.
>
> **platform** `string` *required*
>
> Het platform waarop het bovenliggende externe account bestaat.
>
> Beschikbare opties: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`
>
> **profile\_picture\_url** `string | null` *required*
>
> De URL waar de profielfoto van het bovenliggende externe account te vinden is.
>
> **username** `string | null` *required*
>
> De gebruikersnaam van het bovenliggende externe account op het platform.
>
> **verified** `boolean` *required*
>
> Of het bovenliggende externe account geverifieerd is op het platform.

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

Altijd `null`. Partnership-advertenties zijn niet langer beschikbaar.

**platform** `string` *required*

Het platform waarop het externe account bestaat.

Beschikbare opties: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`

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

De URL waar de profielfoto van het externe account te vinden is.

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

Mogelijkheden die Whop specifiek voor dit externe account behoudt. Whop kan bijvoorbeeld de mogelijkheid aanvragen om advertenties te tonen die de identiteit van dit externe account gebruiken, weergegeven door `advertise`. Koppelingen van persoonlijke profielen hebben geen extra Whop-scopes.

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

De URL waar het externe account op het platform te vinden is. Null zolang een account in eigendom van Whop nog wordt ingericht.

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

De gebruikersnaam van het externe account op het platform. Null zolang een account in eigendom van Whop nog wordt ingericht, en op platforms zonder gebruikersnamen, zoals Klaviyo.

**verified** `boolean` *required*

Of het externe account geverifieerd is op het platform.

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

- [Social Accounts API (verouderd)](https://docs.whop.com/nl/api-reference/social-accounts/social-account.md)
- [Create an External Account](https://docs.whop.com/nl/api-reference/external-accounts/create-an-external-account.md)
- [List External Accounts](https://docs.whop.com/nl/api-reference/external-accounts/list-external-accounts.md)
