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

# Social Accounts API (지원 중단)

> Social Accounts는 External Accounts의 이전 공개 명칭입니다.

기존 통합은 마이그레이션하는 동안 지원 중단된 이 엔드포인트를 계속 호출할 수 있으며, 모든 응답은 대응되는 External Accounts 엔드포인트를 안내합니다.

모든 신규 통합에는 External Accounts API를 사용하세요. 외부 계정 ID는 `sacc_` 접두사를 그대로 유지하며, 기본 리소스는 변경되지 않습니다.

## 엔드포인트

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

## 속성

**id** `string` *required*

소셜 계정의 고유 식별자입니다.

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

이 소셜 계정을 현재 광고에 사용할 수 없는 이유로, 공유 실패 또는 Meta 측
제한 등이 있습니다. 계정이 정상이면 null입니다.

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

이 소셜 계정의 플랫폼별 ID입니다.

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

플랫폼에서의 소셜 계정 표시 이름입니다.

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

플랫폼에서 이 계정이 속한 소셜 계정으로, 예를 들어 Instagram 계정을 소유한 Facebook 페이지입니다. 소셜 계정이 독립적으로 존재하거나 파트너인 경우 null입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> `sacc_` 접두사가 붙은 소셜 계정 ID입니다.
>
> **external\_id** `string | null` *required*
>
> 상위 소셜 계정의 플랫폼별 ID입니다.
>
> **name** `string | null` *required*
>
> 플랫폼에서의 상위 소셜 계정 표시 이름입니다.
>
> **platform** `string` *required*
>
> 상위 소셜 계정이 존재하는 플랫폼입니다.
>
> 사용 가능한 옵션: `x`, `instagram`, `youtube`, `tiktok`, `facebook`, `discord`, `telegram`, `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`, `discord`, `telegram`, `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 SocialAccount theme={null}
{
	"id": "sacc_xxxxxxxxxxxx",
	"external_id": "17841400000000000",
	"name": "Pickaxe Pro",
	"parent_social_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
}
```
