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

# Channel Members API

> 채널 멤버(Channel Member)는 채널에 속한 사람입니다.

비공개 또는 지원 채널에 추가된 사람은 읽음 위치와 알림 설정을 가진 저장된 멤버십을 갖습니다. 익스피리언스 또는 지원 받은편지함에 대한 접근 권한을 통해 채널을 읽는 사람은 저장된 멤버십이 없습니다. 이들의 `id`는 `null`이며, 읽음 위치는 표시되지 않습니다.

Channel Members API를 사용하여 채널에 있는 사람을 [조회하거나 검색](https://docs.whop.com/ko/api-reference/channel-members/list-channel-members.md)하고, 비공개 또는 지원 채널에 사람을 [추가](https://docs.whop.com/ko/api-reference/channel-members/add-channel-member.md)할 수 있습니다. [알림 설정을 변경](https://docs.whop.com/ko/api-reference/channel-members/update-channel-member.md)할 수도 있습니다. 멤버를 [제거](https://docs.whop.com/ko/api-reference/channel-members/remove-channel-member.md)하거나, 자신을 제거하여 채널에서 나갈 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [채널 멤버 목록 조회](https://docs.whop.com/ko/api-reference/channel-members/list-channel-members.md) | GET `/channel_members` |
| [채널 멤버 조회](https://docs.whop.com/ko/api-reference/channel-members/retrieve-channel-member.md) | GET `/channel_members/{id}` |
| [채널 멤버 추가](https://docs.whop.com/ko/api-reference/channel-members/add-channel-member.md) | POST `/channel_members` |
| [채널 멤버 업데이트](https://docs.whop.com/ko/api-reference/channel-members/update-channel-member.md) | PATCH `/channel_members/{id}` |
| [채널 멤버 제거](https://docs.whop.com/ko/api-reference/channel-members/remove-channel-member.md) | DELETE `/channel_members/{id}` |

## 속성

**id** `string | null` *required*

저장된 멤버십 ID이며, 접근 권한에서 파생된 사용자는 null입니다.

**channel\_id** `string` *required*

**created\_at** `string | null` *required*

저장된 채널 멤버십이 생성된 시점으로, ISO 8601 타임스탬프입니다. 접근 권한에 저장된 멤버십이 없는 사용자는 null입니다.

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

비공개 채널에 대한 내 받은편지함 상태입니다. 다른 사용자와 다른 채널 유형에서는 `null`입니다.

사용 가능한 옵션: `requested`, `accepted`, `hidden`

**last\_viewed\_at** `string | null` *required*

권한 있는 참여자의 읽음 위치입니다. 커뮤니티 채널의 위치는 해당 사용자 본인에게만 표시됩니다.

**notification\_preference** `string | null` *required*

사용 가능한 옵션: `all`, `mentions`, `none`

**pinned\_position** `integer | null` *required*

**unread** `boolean | null` *required*

채널에 대한 내 읽지 않음 상태입니다. 다른 사용자는 `null`입니다.

**updated\_at** `string | null` *required*

저장된 채널 멤버십이 마지막으로 변경된 시점으로, ISO 8601 타임스탬프입니다. 접근 권한에 저장된 멤버십이 없는 사용자는 null입니다.

**user** `object` *required*

> [accordion] 속성
>
> **id** `string` *required*
>
> 사용자 ID이며, 접두사는 `user_`입니다.
>
> **name** `string | null` *required*
>
> 표시 이름입니다.
>
> **profile\_picture** `object` *required*
>
> 아바타 래퍼입니다. `url`은 항상 존재하며, 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> > [accordion] 속성
> >
> > **url** `string` *required*
> >
> > 아바타 이미지 URL입니다. 항상 존재합니다. 사용자가 사진을 설정하지 않은 경우 생성된 플레이스홀더입니다.
>
> **username** `string` *required*
>
> 공개 사용자 이름입니다.

**user\_id** `string` *required*

사용자 ID

```json ChannelMember theme={null}
{
	"id": "memb_1_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
	"channel_id": "feed_xxxxxxxxxxxxxxxxxxxxxx",
	"user_id": "user_xxxxxxxxxxxxxx",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"username": "danawhitfield",
		"name": "Dana Whitfield",
		"profile_picture": {
			"url": "https://img.whop.com/avatars/user_xxxxxxxxxxxxxx.png"
		}
	},
	"created_at": "2026-09-02T16:20:11.000Z",
	"updated_at": "2026-10-14T09:15:02.000Z",
	"last_viewed_at": "2026-10-14T09:15:02.000Z",
	"unread": false,
	"notification_preference": "mentions",
	"pinned_position": 0,
	"inbox_status": "accepted"
}
```
