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

> External Account, bir Whop hesabına veya kullanıcısına bağlı başka bir platformdaki hesabı temsil eder; örneğin bir Facebook sayfası, Instagram hesabı, TikTok hesabı veya Klaviyo hesabı.

Bunu OAuth veya bir API anahtarı aracılığıyla bağlarsınız ya da Whop sizin için oluşturur. Harici hesap kimlikleri `sacc_` önekiyle başlar.

External Accounts API'yi bağlı hesapları listelemek, [OAuth aracılığıyla bir profil bağlamak](https://docs.whop.com/tr/api-reference/external-accounts/connect-an-external-account.md), [Whop tarafından yönetilen bir Facebook sayfası veya TikTok hesabı oluşturmak ya da bir Klaviyo hesabını API anahtarıyla bağlamak](https://docs.whop.com/tr/api-reference/external-accounts/create-an-external-account.md) ve bir harici hesabın bağlantısını kesmek için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Harici Hesapları Listele](https://docs.whop.com/tr/api-reference/external-accounts/list-external-accounts.md) | GET `/external_accounts` |
| [Harici Hesap Oluştur](https://docs.whop.com/tr/api-reference/external-accounts/create-an-external-account.md) | POST `/external_accounts` |
| [Yenile](https://docs.whop.com/tr/api-reference/external-accounts/refresh.md) | POST `/external_accounts/{id}/refresh` |
| [Harici Hesap Bağla](https://docs.whop.com/tr/api-reference/external-accounts/connect-an-external-account.md) | POST `/external_accounts/connect` |
| [Harici Hesabı Sil](https://docs.whop.com/tr/api-reference/external-accounts/delete-an-external-account.md) | DELETE `/external_accounts/{id}` |

## Öznitelikler

**id** `string` *required*

Harici hesabın benzersiz tanımlayıcısı.

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

Bu harici hesabın şu anda neden reklam için kullanılamadığı — başarısız bir paylaşım veya Meta tarafındaki bir kısıtlama. Hesap sağlıklı olduğunda null.

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

Bu harici hesabın platforma özgü kimliği.

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

Harici hesabın platformdaki görünen adı.

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

Bu hesabın platformda ait olduğu harici hesap; örneğin bir Instagram hesabının sahibi olan Facebook sayfası. Harici hesap tek başına duruyorsa veya bir iş ortağıysa null.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `sacc_` önekli harici hesap kimliği.
>
> **external\_id** `string | null` *required*
>
> Üst harici hesabın platforma özgü kimliği.
>
> **name** `string | null` *required*
>
> Üst harici hesabın platformdaki görünen adı.
>
> **platform** `string` *required*
>
> Üst harici hesabın bulunduğu platform.
>
> Kullanılabilir seçenekler: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`
>
> **profile\_picture\_url** `string | null` *required*
>
> Üst harici hesabın profil resmine erişilebilen URL.
>
> **username** `string | null` *required*
>
> Üst harici hesabın platformdaki kullanıcı adı.
>
> **verified** `boolean` *required*
>
> Üst harici hesabın platformda doğrulanmış olup olmadığı.

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

Her zaman `null`. Ortaklık reklamları artık kullanılamıyor.

**platform** `string` *required*

Harici hesabın bulunduğu platform.

Kullanılabilir seçenekler: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`

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

Harici hesabın profil resmine erişilebilen URL.

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

Whop'un bu harici hesaba özel olarak elinde tuttuğu yetenekler. Örneğin Whop, bu harici hesabın kimliğini kullanan reklamlar yayınlama yetkisi isteyebilir; bu `advertise` ile gösterilir. Kişisel profil bağlantılarının ek Whop kapsamları yoktur.

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

Harici hesaba platformda erişilebilen URL. Whop'a ait bir hesap hâlâ hazırlanırken null.

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

Harici hesabın platformdaki kullanıcı adı. Whop'a ait bir hesap hâlâ hazırlanırken ve Klaviyo gibi kullanıcı adı olmayan platformlarda null.

**verified** `boolean` *required*

Harici hesabın platformda doğrulanmış olup olmadığı.

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

- [Create an External Account](https://docs.whop.com/tr/api-reference/external-accounts/create-an-external-account.md)
- [Refresh External Account](https://docs.whop.com/api-reference/external-accounts/refresh.md)
- [List External Accounts](https://docs.whop.com/tr/api-reference/external-accounts/list-external-accounts.md)
