> ## 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는 Facebook 페이지, Instagram 계정, TikTok 계정, Klaviyo 계정처럼 Whop 계정 또는 사용자에 연결된 다른 플랫폼의 계정을 나타냅니다.

OAuth 또는 API 키를 통해 연결하거나, Whop이 대신 생성합니다. External account ID는 `sacc_` 접두사로 시작합니다.

External Accounts API를 사용하여 연결된 계정을 조회하고, [OAuth를 통해 프로필을 연결하고](https://docs.whop.com/ko/api-reference/external-accounts/connect-an-external-account.md), [Whop이 관리하는 Facebook 페이지 또는 TikTok 계정을 생성하거나 API 키로 Klaviyo 계정을 연결하고](https://docs.whop.com/ko/api-reference/external-accounts/create-an-external-account.md), 외부 계정 연결을 해제할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [External Account 목록 조회](https://docs.whop.com/ko/api-reference/external-accounts/list-external-accounts.md) | GET `/external_accounts` |
| [External Account 생성](https://docs.whop.com/ko/api-reference/external-accounts/create-an-external-account.md) | POST `/external_accounts` |
| [새로 고침](https://docs.whop.com/ko/api-reference/external-accounts/refresh.md) | POST `/external_accounts/{id}/refresh` |
| [External Account 연결](https://docs.whop.com/ko/api-reference/external-accounts/connect-an-external-account.md) | POST `/external_accounts/connect` |
| [External Account 삭제](https://docs.whop.com/ko/api-reference/external-accounts/delete-an-external-account.md) | DELETE `/external_accounts/{id}` |

## 속성

**id** `string` *required*

외부 계정의 고유 식별자입니다.

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

이 외부 계정을 현재 광고에 사용할 수 없는 이유입니다(공유 실패 또는 Meta 측 제한 등). 계정이 정상이면 Null입니다.

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

이 외부 계정의 플랫폼별 ID입니다.

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

플랫폼에서 표시되는 외부 계정의 이름입니다.

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

플랫폼에서 이 계정이 속한 외부 계정입니다(예: Instagram 계정을 소유한 Facebook 페이지). 외부 계정이 독립적으로 존재하거나 파트너인 경우 Null입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 외부 계정 ID이며, `sacc_` 접두사로 시작합니다.
>
> **external\_id** `string | null` *required*
>
> 상위 외부 계정의 플랫폼별 ID입니다.
>
> **name** `string | null` *required*
>
> 플랫폼에서 표시되는 상위 외부 계정의 이름입니다.
>
> **platform** `string` *required*
>
> 상위 외부 계정이 존재하는 플랫폼입니다.
>
> 사용 가능한 옵션: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`
>
> **profile\_picture\_url** `string | null` *required*
>
> 상위 외부 계정의 프로필 사진에 접근할 수 있는 URL입니다.
>
> **username** `string | null` *required*
>
> 플랫폼에서 사용하는 상위 외부 계정의 사용자 이름입니다.
>
> **verified** `boolean` *required*
>
> 상위 외부 계정이 플랫폼에서 인증되었는지 여부입니다.

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

항상 `null`입니다. 파트너십 광고는 더 이상 제공되지 않습니다.

**platform** `string` *required*

외부 계정이 존재하는 플랫폼입니다.

사용 가능한 옵션: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `linkedin`, `snapchat`, `klaviyo`, `quickbooks`, `aimerce`

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

외부 계정의 프로필 사진에 접근할 수 있는 URL입니다.

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

이 외부 계정에 대해 Whop이 보유한 권한입니다. 예를 들어 Whop은 이 외부 계정의 정체성을 사용하는 광고를 게재할 권한을 요청할 수 있으며, 이는 `advertise`로 표시됩니다. 개인 프로필 연결에는 추가적인 Whop 스코프가 없습니다.

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

플랫폼에서 외부 계정에 접근할 수 있는 URL입니다. Whop 소유 계정이 아직 프로비저닝 중인 동안에는 Null입니다.

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

플랫폼에서 사용하는 외부 계정의 사용자 이름입니다. Whop 소유 계정이 아직 프로비저닝 중이거나, Klaviyo처럼 사용자 이름이 없는 플랫폼에서는 Null입니다.

**verified** `boolean` *required*

외부 계정이 플랫폼에서 인증되었는지 여부입니다.

```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 (지원 중단)](https://docs.whop.com/ko/api-reference/social-accounts/social-account.md)
- [Create an External Account](https://docs.whop.com/ko/api-reference/external-accounts/create-an-external-account.md)
- [Refresh External Account](https://docs.whop.com/api-reference/external-accounts/refresh.md)
