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

# Channels API

> 채널(Channel)은 채팅 메시지를 담는 Whop의 대화입니다. `private` 채널은 일대일 또는 그룹 대화입니다.

`community` 채널은 계정의 Chat 익스피리언스 중 하나에 있는 채팅입니다. `support` 채널은 계정과 한 고객 간의 대화입니다.

Channels API를 사용하여 채널을 [생성](https://docs.whop.com/ko/api-reference/channels/create-channel.md)하고 [목록을 조회](https://docs.whop.com/ko/api-reference/channels/list-channels.md)하며, 채널 자체 ID 또는 해당 Chat 익스피리언스의 ID로 채널을 [조회](https://docs.whop.com/ko/api-reference/channels/retrieve-channel.md)할 수 있습니다. 또한 다이렉트 메시지 요청을 [수락](https://docs.whop.com/ko/api-reference/channels/accept-dm-request.md)하거나 [거절](https://docs.whop.com/ko/api-reference/channels/decline-dm-request.md)하고, [채널을 읽음으로 표시](https://docs.whop.com/ko/api-reference/channels/mark-channel-read.md)하고, 지원 대화를 [해결](https://docs.whop.com/ko/api-reference/channels/resolve-support-channel.md)하거나 [다시 열](https://docs.whop.com/ko/api-reference/channels/reopen-support-channel.md) 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [채널 목록 조회](https://docs.whop.com/ko/api-reference/channels/list-channels.md) | GET `/channels` |
| [채널 조회](https://docs.whop.com/ko/api-reference/channels/retrieve-channel.md) | GET `/channels/{id}` |
| [채널 생성](https://docs.whop.com/ko/api-reference/channels/create-channel.md) | POST `/channels` |
| [DM 요청 수락](https://docs.whop.com/ko/api-reference/channels/accept-dm-request.md) | POST `/channels/{id}/accept` |
| [DM 요청 거절](https://docs.whop.com/ko/api-reference/channels/decline-dm-request.md) | POST `/channels/{id}/hide` |
| [채널 읽음으로 표시](https://docs.whop.com/ko/api-reference/channels/mark-channel-read.md) | POST `/channels/{id}/mark_read` |
| [채널 읽지 않음으로 표시](https://docs.whop.com/ko/api-reference/channels/mark-channel-unread.md) | POST `/channels/{id}/mark_unread` |
| [채널 고정](https://docs.whop.com/ko/api-reference/channels/pin-channel.md) | POST `/channels/{id}/pin` |
| [지원 채널 다시 열기](https://docs.whop.com/ko/api-reference/channels/reopen-support-channel.md) | POST `/channels/{id}/reopen` |
| [지원 채널 해결](https://docs.whop.com/ko/api-reference/channels/resolve-support-channel.md) | POST `/channels/{id}/resolve` |
| [채널 고정 해제](https://docs.whop.com/ko/api-reference/channels/unpin-channel.md) | POST `/channels/{id}/unpin` |
| [채널 업데이트](https://docs.whop.com/ko/api-reference/channels/update-channel.md) | PATCH `/channels/{id}` |
| [채널 삭제](https://docs.whop.com/ko/api-reference/channels/delete-channel.md) | DELETE `/channels/{id}` |

## 속성

**id** `string` *required*

기존 공개 채널 ID로, REST와 채팅 클라이언트 전반에서 유지됩니다.

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

**created\_at** `string` *required*

생성 시간으로, ISO 8601 타임스탬프입니다.

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

채널이 삭제되었거나 채널 목록에서 제거된 시점으로, ISO 8601 타임스탬프입니다. 활성 채널은 null입니다.

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

**icon** `object | null` *required*

채널 아이콘입니다. 커뮤니티 채널은 익스피리언스 로고를 표시하며, 없으면 앱 아이콘을 표시합니다. 지원 채널은 계정 로고를 표시합니다. 그룹 비공개 채널은 자체 아이콘을 표시합니다. 일대일 비공개 채널이거나 이미지가 설정되지 않은 경우 null입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 파일 ID이며, 접두사는 `file_`입니다.
>
> **blurhash** `string | null` *required*
>
> 이미지 또는 비디오의 BlurHash 플레이스홀더입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
>
> **content\_type** `string | null` *required*
>
> 원본 파일의 MIME 유형입니다(예: `application/pdf`). 모더레이션으로 파일이 제거되어도 유지됩니다.
>
> **created\_at** `string` *required*
>
> 파일이 생성된 시점으로, ISO 8601 타임스탬프입니다.
>
> **duration\_seconds** `number | null` *required*
>
> 오디오 또는 비디오 길이(초)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
>
> **filename** `string | null` *required*
>
> 확장자를 포함한 원본 파일 이름입니다.
>
> **height** `integer | null` *required*
>
> 이미지 또는 비디오 높이(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
>
> **multipart\_chunk\_size** `integer | null`
>
> 각 파트(마지막 파트 제외)의 바이트 크기입니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_id** `string | null`
>
> 멀티파트 업로드의 ID로, `complete`에 다시 전달합니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
>
> **multipart\_upload\_urls** `object[] | null`
>
> 각 파트의 미리 서명된 URL입니다. 생성 시에만, 멀티파트 업로드에만 존재합니다.
>
> > [accordion] 속성
> >
> > **part\_number** `integer` *required*
> >
> > 멀티파트 업로드 내에서 이 파트의 인덱스(1부터 시작)입니다.
> >
> > **url** `string` *required*
> >
> > 이 파트의 바이트를 PUT할 미리 서명된 URL입니다.
>
> **object** `string` *required*
>
> 이 객체의 유형으로, 항상 `file`입니다.
>
> **removed\_by\_moderation** `boolean` *required*
>
> 모더레이션으로 파일이 제거되었는지 여부입니다. `true`이면 `url`은 대체 이미지를 제공합니다. `filename`, `size`, `content_type`은 여전히 원본 파일을 설명합니다.
>
> **size** `integer | null` *required*
>
> 파일 크기(바이트)입니다. 업로드가 완료될 때까지 `null`입니다.
>
> **upload\_headers** `object`
>
> 업로드 PUT 요청과 함께 보낼 헤더입니다. 생성 시에만 존재합니다.
>
> **upload\_status** `string` *required*
>
> 파일의 업로드 수명 주기 단계입니다.
>
> 사용 가능한 옵션: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> 파일의 바이트를 PUT할 미리 서명된 URL입니다. 생성 시에만, 단일 파트 업로드에만 존재합니다.
>
> **url** `string | null` *required*
>
> 파일을 다운로드할 수 있는 URL입니다. 공개 파일은 영구 CDN URL을, 비공개 파일은 만료되는 서명 URL을 받습니다. 업로드가 완료될 때까지 `null`입니다. 모더레이션으로 파일이 제거된 경우 대체 이미지 URL입니다.
>
> **visibility** `string` *required*
>
> `public` 파일은 서명되지 않은 CDN URL에서 제공됩니다. `private` 파일은 만료되는 서명 URL에서 제공됩니다.
>
> 사용 가능한 옵션: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> 오디오 파형 URL입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.
>
> **width** `integer | null` *required*
>
> 이미지 또는 비디오 너비(픽셀)입니다. 사용할 수 없거나 모더레이션으로 제거된 경우 null입니다.

**kind** `string` *required*

사용 가능한 옵션: `private`, `community`, `support`

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

채널에 마지막으로 메시지 활동이 기록된 시점으로, ISO 8601 타임스탬프입니다. 기록된 메시지 활동이 없으면 null입니다.

**last\_message\_id** `string | null` *required*

**membership** `object | null` *required*

> [accordion] 속성
>
> **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

**moderation** `object | null` *required*

> [accordion] 속성
>
> **ban\_media** `boolean` *required*
>
> 멤버가 미디어를 게시하지 못하도록 합니다.
>
> **ban\_urls** `boolean` *required*
>
> 멤버가 링크를 게시하지 못하도록 합니다.
>
> **banned\_words** `string[] | null` *required*
>
> 채널에서 차단된 단어입니다. 이 설정을 볼 수 없으면 `null`이며, 빈 목록은 차단된 단어가 없음을 의미합니다.
>
> **user\_posts\_cooldown\_seconds** `integer | null` *required*
>
> 멤버가 메시지 사이에 기다려야 하는 시간(초)입니다. `0` 또는 `null`이면 쿨다운이 꺼집니다.
>
> **who\_can\_post** `string` *required*
>
> 메시지를 게시할 수 있는 사람입니다.
>
> 사용 가능한 옵션: `everyone`, `admins`
>
> **who\_can\_react** `string` *required*
>
> 메시지에 반응할 수 있는 사람입니다.
>
> 사용 가능한 옵션: `everyone`, `no_one`

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

**notifications\_enabled** `boolean` *required*

앱 알림이 켜져 있는지 여부입니다. 웹훅은 어느 경우에나 발생합니다.

**support** `object | null` *required*

> [accordion] 속성
>
> **awaiting\_reply** `boolean` *required*
>
> **customer\_user\_id** `string` *required*
>
> **last\_message\_by** `string | null` *required*
>
> 사용 가능한 옵션: `customer`, `support`
>
> **resolved\_at** `string | null` *required*
>
> 지원 대화가 해결된 시점으로, ISO 8601 타임스탬프입니다. 해결되지 않은 동안에는 null입니다.
>
> **status** `string` *required*
>
> 사용 가능한 옵션: `unresolved`, `resolved`

**updated\_at** `string` *required*

마지막 채널 변경 시점으로, ISO 8601 타임스탬프입니다.

```json Channel theme={null}
{
	"id": "feed_xxxxxxxxxxxxxxxxxxxxxx",
	"kind": "community",
	"name": "Detailing Talk",
	"icon": {
		"id": "file_xxxxxxxxxxxxxx",
		"object": "file",
		"filename": "detailing-talk.png",
		"content_type": "image/png",
		"size": 48213,
		"url": "https://img.whop.com/uploads/detailing-talk.png",
		"removed_by_moderation": false,
		"upload_status": "ready",
		"visibility": "public",
		"created_at": "2026-09-02T16:20:11.000Z",
		"width": 512,
		"height": 512,
		"blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
		"duration_seconds": null,
		"waveform_url": null
	},
	"notifications_enabled": true,
	"account_id": "biz_xxxxxxxxxxxxxx",
	"experience_id": "exp_xxxxxxxxxxxxxx",
	"created_at": "2026-09-02T16:20:11.000Z",
	"updated_at": "2026-10-14T09:12:40.000Z",
	"deleted_at": null,
	"last_message_id": "post_xxxxxxxxxxxxxxxxxxxxxx",
	"last_message_at": "2026-10-14T09:12:40.000Z",
	"membership": null,
	"support": null,
	"moderation": {
		"ban_media": false,
		"ban_urls": true,
		"banned_words": ["giveaway", "crypto"],
		"who_can_post": "everyone",
		"who_can_react": "everyone",
		"user_posts_cooldown_seconds": 30
	}
}
```
