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

# API de Channels

> Un Channel es una conversación en Whop que contiene mensajes de chat. Un canal `private` es una conversación individual o grupal.

Un canal `community` es el chat de una de las experiencias de Chat de una cuenta. Un canal `support` es una conversación entre una cuenta y un cliente.

Usa la API de Channels para [crear](https://docs.whop.com/es/api-reference/channels/create-channel.md) y [listar](https://docs.whop.com/es/api-reference/channels/list-channels.md) canales, y para [recuperar](https://docs.whop.com/es/api-reference/channels/retrieve-channel.md) uno por su propio ID o por el ID de su experiencia de Chat. También puedes [aceptar](https://docs.whop.com/es/api-reference/channels/accept-dm-request.md) o [rechazar](https://docs.whop.com/es/api-reference/channels/decline-dm-request.md) solicitudes de mensajes directos, [marcar un canal como leído](https://docs.whop.com/es/api-reference/channels/mark-channel-read.md) y [resolver](https://docs.whop.com/es/api-reference/channels/resolve-support-channel.md) o [reabrir](https://docs.whop.com/es/api-reference/channels/reopen-support-channel.md) conversaciones de soporte.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar Channels](https://docs.whop.com/es/api-reference/channels/list-channels.md) | GET `/channels` |
| [Recuperar Channel](https://docs.whop.com/es/api-reference/channels/retrieve-channel.md) | GET `/channels/{id}` |
| [Crear Channel](https://docs.whop.com/es/api-reference/channels/create-channel.md) | POST `/channels` |
| [Aceptar solicitud de DM](https://docs.whop.com/es/api-reference/channels/accept-dm-request.md) | POST `/channels/{id}/accept` |
| [Rechazar solicitud de DM](https://docs.whop.com/es/api-reference/channels/decline-dm-request.md) | POST `/channels/{id}/hide` |
| [Marcar Channel como leído](https://docs.whop.com/es/api-reference/channels/mark-channel-read.md) | POST `/channels/{id}/mark_read` |
| [Marcar Channel como no leído](https://docs.whop.com/es/api-reference/channels/mark-channel-unread.md) | POST `/channels/{id}/mark_unread` |
| [Fijar Channel](https://docs.whop.com/es/api-reference/channels/pin-channel.md) | POST `/channels/{id}/pin` |
| [Reabrir Channel de soporte](https://docs.whop.com/es/api-reference/channels/reopen-support-channel.md) | POST `/channels/{id}/reopen` |
| [Resolver Channel de soporte](https://docs.whop.com/es/api-reference/channels/resolve-support-channel.md) | POST `/channels/{id}/resolve` |
| [Desfijar Channel](https://docs.whop.com/es/api-reference/channels/unpin-channel.md) | POST `/channels/{id}/unpin` |
| [Actualizar Channel](https://docs.whop.com/es/api-reference/channels/update-channel.md) | PATCH `/channels/{id}` |
| [Eliminar Channel](https://docs.whop.com/es/api-reference/channels/delete-channel.md) | DELETE `/channels/{id}` |

## Atributos

**id** `string` *required*

ID público existente del canal, conservado entre REST y los clientes de chat.

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

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

Hora de creación como marca de tiempo ISO 8601.

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

Cuándo se eliminó el canal o se quitó de tu lista de canales, como marca de tiempo ISO 8601. Null para un canal activo.

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

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

El icono del canal. Los canales de comunidad muestran el logotipo de la experiencia y, si no hay, el icono de la app. Los canales de soporte muestran el logotipo de la cuenta. Los canales privados grupales muestran su propio icono. Null para canales privados individuales o cuando no hay imagen configurada.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un video. Null cuando no está disponible o fue eliminado por moderación.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o video en segundos. Null cuando no está disponible o fue eliminado por moderación.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Presente solo al crear y solo para subidas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la subida multiparte, que se devuelve a `complete`. Presente solo al crear y solo para subidas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Presente solo al crear y solo para subidas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando en 1, de esta parte dentro de la subida multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que hacer PUT de los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de reemplazo. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que termina la subida.
>
> **upload\_headers** `object`
>
> Encabezados que se deben enviar con el PUT de la subida. Presente solo al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto de su ciclo de vida de subida se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que hacer PUT de los bytes del archivo. Presente solo al crear y solo para subidas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los privados una URL firmada que caduca. `null` hasta que termina la subida. Cuando la moderación elimina el archivo, una URL de imagen de reemplazo.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o fue eliminada por moderación.
>
> **width** `integer | null` *required*
>
> Ancho de la imagen o el video en píxeles. Null cuando no está disponible o fue eliminado por moderación.

**kind** `string` *required*

Opciones disponibles: `private`, `community`, `support`

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

Cuándo registró el canal actividad de mensajes por última vez, como marca de tiempo ISO 8601. Null cuando no hay actividad de mensajes registrada.

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

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

> [accordion] Propiedades
>
> **id** `string | null` *required*
>
> ID de la membresía almacenada, o null para usuarios con acceso derivado.
>
> **channel\_id** `string` *required*
>
> **created\_at** `string | null` *required*
>
> Cuándo se creó la membresía del canal almacenada, como marca de tiempo ISO 8601. Null para usuarios cuyo acceso no tiene una membresía almacenada.
>
> **inbox\_status** `string | null` *required*
>
> Tu estado de bandeja de entrada para un canal privado. `null` para otros usuarios y otros tipos de canal.
>
> Opciones disponibles: `requested`, `accepted`, `hidden`
>
> **last\_viewed\_at** `string | null` *required*
>
> Posición de lectura del participante autorizado. Las posiciones en comunidades solo son visibles para el propio usuario.
>
> **notification\_preference** `string | null` *required*
>
> Opciones disponibles: `all`, `mentions`, `none`
>
> **pinned\_position** `integer | null` *required*
>
> **unread** `boolean | null` *required*
>
> Tu estado de no leídos del canal. `null` para otros usuarios.
>
> **updated\_at** `string | null` *required*
>
> Cuándo cambió por última vez la membresía del canal almacenada, como marca de tiempo ISO 8601. Null para usuarios cuyo acceso no tiene una membresía almacenada.
>
> **user** `object` *required*
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID de usuario, con el prefijo `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nombre para mostrar.
> >
> > **profile\_picture** `object` *required*
> >
> > Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha configurado ninguna imagen.
> >
> > > [accordion] Propiedades
> > >
> > > **url** `string` *required*
> > >
> > > URL de la imagen del avatar. Siempre presente. Es un marcador de posición generado cuando el usuario no ha configurado ninguna imagen.
> >
> > **username** `string` *required*
> >
> > Nombre de usuario público.
>
> **user\_id** `string` *required*
>
> ID de usuario

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

> [accordion] Propiedades
>
> **ban\_media** `boolean` *required*
>
> Impedir que los miembros publiquen contenido multimedia.
>
> **ban\_urls** `boolean` *required*
>
> Impedir que los miembros publiquen enlaces.
>
> **banned\_words** `string[] | null` *required*
>
> Palabras bloqueadas en el canal. `null` cuando no puedes ver esta configuración; una lista vacía significa que no hay palabras bloqueadas.
>
> **user\_posts\_cooldown\_seconds** `integer | null` *required*
>
> Segundos que un miembro debe esperar entre mensajes. `0` o `null` desactiva el tiempo de espera.
>
> **who\_can\_post** `string` *required*
>
> Quién puede publicar mensajes.
>
> Opciones disponibles: `everyone`, `admins`
>
> **who\_can\_react** `string` *required*
>
> Quién puede reaccionar a los mensajes.
>
> Opciones disponibles: `everyone`, `no_one`

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

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

Si las notificaciones de la app están activadas. Los webhooks se disparan en cualquier caso.

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

> [accordion] Propiedades
>
> **awaiting\_reply** `boolean` *required*
>
> **customer\_user\_id** `string` *required*
>
> **last\_message\_by** `string | null` *required*
>
> Opciones disponibles: `customer`, `support`
>
> **resolved\_at** `string | null` *required*
>
> Cuándo se resolvió la conversación de soporte, como marca de tiempo ISO 8601. Null mientras no esté resuelta.
>
> **status** `string` *required*
>
> Opciones disponibles: `unresolved`, `resolved`

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

Último cambio del canal como marca de tiempo 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
	}
}
```


## Related topics

- [API de Channel Members](https://docs.whop.com/es/api-reference/channel-members/channel-member.md)
- [API de chat](https://docs.whop.com/es/developer/guides/chat.md)
- [API de Messages](https://docs.whop.com/es/api-reference/messages/message.md)
