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

> Un Channel est une conversation sur Whop qui contient des messages de chat. Un canal `private` est une conversation individuelle ou de groupe.

Un canal `community` est le chat de l'une des expériences Chat d'un compte. Un canal `support` est une conversation entre un compte et un client.

Utilisez l'API Channels pour [créer](https://docs.whop.com/fr/api-reference/channels/create-channel.md) et [lister](https://docs.whop.com/fr/api-reference/channels/list-channels.md) des canaux, et pour en [récupérer](https://docs.whop.com/fr/api-reference/channels/retrieve-channel.md) un par son propre ID ou par l'ID de son expérience Chat. Vous pouvez également [accepter](https://docs.whop.com/fr/api-reference/channels/accept-dm-request.md) ou [refuser](https://docs.whop.com/fr/api-reference/channels/decline-dm-request.md) des demandes de messages privés, [marquer un canal comme lu](https://docs.whop.com/fr/api-reference/channels/mark-channel-read.md), et [résoudre](https://docs.whop.com/fr/api-reference/channels/resolve-support-channel.md) ou [rouvrir](https://docs.whop.com/fr/api-reference/channels/reopen-support-channel.md) des conversations de support.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les canaux](https://docs.whop.com/fr/api-reference/channels/list-channels.md) | GET `/channels` |
| [Récupérer un canal](https://docs.whop.com/fr/api-reference/channels/retrieve-channel.md) | GET `/channels/{id}` |
| [Créer un canal](https://docs.whop.com/fr/api-reference/channels/create-channel.md) | POST `/channels` |
| [Accepter une demande de message privé](https://docs.whop.com/fr/api-reference/channels/accept-dm-request.md) | POST `/channels/{id}/accept` |
| [Refuser une demande de message privé](https://docs.whop.com/fr/api-reference/channels/decline-dm-request.md) | POST `/channels/{id}/hide` |
| [Marquer un canal comme lu](https://docs.whop.com/fr/api-reference/channels/mark-channel-read.md) | POST `/channels/{id}/mark_read` |
| [Marquer un canal comme non lu](https://docs.whop.com/fr/api-reference/channels/mark-channel-unread.md) | POST `/channels/{id}/mark_unread` |
| [Épingler un canal](https://docs.whop.com/fr/api-reference/channels/pin-channel.md) | POST `/channels/{id}/pin` |
| [Rouvrir un canal de support](https://docs.whop.com/fr/api-reference/channels/reopen-support-channel.md) | POST `/channels/{id}/reopen` |
| [Résoudre un canal de support](https://docs.whop.com/fr/api-reference/channels/resolve-support-channel.md) | POST `/channels/{id}/resolve` |
| [Désépingler un canal](https://docs.whop.com/fr/api-reference/channels/unpin-channel.md) | POST `/channels/{id}/unpin` |
| [Mettre à jour un canal](https://docs.whop.com/fr/api-reference/channels/update-channel.md) | PATCH `/channels/{id}` |
| [Supprimer un canal](https://docs.whop.com/fr/api-reference/channels/delete-channel.md) | DELETE `/channels/{id}` |

## Attributs

**id** `string` *required*

ID public existant du canal, conservé entre les clients REST et chat.

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

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

Date de création sous forme d'horodatage ISO 8601.

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

Date à laquelle le canal a été supprimé ou retiré de votre liste de canaux,
sous forme d'horodatage ISO 8601. Null pour un canal actif.

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

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

L'icône du canal. Les canaux de communauté affichent le logo de l'expérience, ou à défaut l'icône de l'app. Les canaux de support affichent le logo du compte. Les canaux privés de groupe affichent leur propre icône. Null pour les canaux privés individuels ou lorsqu'aucune image n'est définie.

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Placeholder BlurHash pour une image ou une vidéo. Null lorsqu'il n'est pas
> disponible ou a été supprimé par la modération.
>
> **content\_type** `string | null` *required*
>
> Le type MIME du fichier d'origine, par exemple `application/pdf`. Il est
> conservé lorsque la modération supprime le fichier.
>
> **created\_at** `string` *required*
>
> Date de création du fichier, sous forme d'horodatage ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Durée de l'audio ou de la vidéo en secondes. Null lorsqu'elle n'est pas
> disponible ou a été supprimée par la modération.
>
> **filename** `string | null` *required*
>
> Le nom de fichier d'origine, extension comprise.
>
> **height** `integer | null` *required*
>
> Hauteur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas
> disponible ou a été supprimée par la modération.
>
> **multipart\_chunk\_size** `integer | null`
>
> La taille en octets que doit avoir chaque partie (sauf la dernière). Présent
> uniquement lors de la création, et uniquement pour les importations multipart.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID de l'importation multipart, à renvoyer à `complete`. Présent uniquement
> lors de la création, et uniquement pour les importations multipart.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présent uniquement lors de la création, et uniquement pour les importations multipart.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie au sein de l'importation multipart.
> >
> > **url** `string` *required*
> >
> > L'URL présignée vers laquelle envoyer (PUT) les octets de cette partie.
>
> **object** `string` *required*
>
> Le type de cet objet, toujours `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Indique si la modération a supprimé le fichier. Lorsque `true`, `url` sert une
> image de remplacement. `filename`, `size` et `content_type` décrivent toujours
> le fichier d'origine.
>
> **size** `integer | null` *required*
>
> La taille du fichier en octets. `null` tant que l'importation n'est pas
> terminée.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec le PUT d'importation. Présent uniquement lors de la
> création.
>
> **upload\_status** `string` *required*
>
> L'étape où se trouve le fichier dans son cycle de vie d'importation.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présent
> uniquement lors de la création, et uniquement pour les importations en une
> seule partie.
>
> **url** `string | null` *required*
>
> Une URL pour télécharger le fichier. Les fichiers publics obtiennent une URL
> CDN permanente, et les fichiers privés une URL signée qui expire. `null` tant
> que l'importation n'est pas terminée. Lorsque la modération supprime le
> fichier, une URL d'image de remplacement.
>
> **visibility** `string` *required*
>
> Les fichiers `public` sont servis depuis une URL CDN non signée. Les fichiers `private` sont servis depuis une URL signée qui expire.
>
> Options disponibles : `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forme d'onde audio. Null lorsqu'elle n'est pas disponible ou a été
> supprimée par la modération.
>
> **width** `integer | null` *required*
>
> Largeur de l'image ou de la vidéo en pixels. Null lorsqu'elle n'est pas disponible ou a été supprimée par la modération.

**kind** `string` *required*

Options disponibles : `private`, `community`, `support`

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

Date de la dernière activité de message enregistrée dans le canal, sous forme
d'horodatage ISO 8601. Null lorsqu'aucune activité de message n'est
enregistrée.

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

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

> [accordion] Propriétés
>
> **id** `string | null` *required*
>
> ID de l'adhésion enregistrée, ou null pour les utilisateurs dont l'accès est dérivé.
>
> **channel\_id** `string` *required*
>
> **created\_at** `string | null` *required*
>
> Date de création de l'adhésion enregistrée au canal, sous forme d'horodatage
> ISO 8601. Null pour les utilisateurs dont l'accès n'a pas d'adhésion enregistrée.
>
> **inbox\_status** `string | null` *required*
>
> Votre état de boîte de réception pour un canal privé. `null` pour les autres utilisateurs et les autres types de canaux.
>
> Options disponibles : `requested`, `accepted`, `hidden`
>
> **last\_viewed\_at** `string | null` *required*
>
> Position de lecture du participant autorisé. Les positions dans la communauté
> ne sont visibles que par l'utilisateur lui-même.
>
> **notification\_preference** `string | null` *required*
>
> Options disponibles : `all`, `mentions`, `none`
>
> **pinned\_position** `integer | null` *required*
>
> **unread** `boolean | null` *required*
>
> Votre état de lecture pour le canal. `null` pour les autres utilisateurs.
>
> **updated\_at** `string | null` *required*
>
> Date de dernière modification de l'adhésion enregistrée au canal, sous forme
> d'horodatage ISO 8601. Null pour les utilisateurs dont l'accès n'a pas
> d'adhésion enregistrée.
>
> **user** `object` *required*
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > ID de l'utilisateur, préfixé par `user_`.
> >
> > **name** `string | null` *required*
> >
> > Nom d'affichage.
> >
> > **profile\_picture** `object` *required*
> >
> > Conteneur de l'avatar. Son `url` est toujours présente et correspond à une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
> >
> > > [accordion] Propriétés
> > >
> > > **url** `string` *required*
> > >
> > > URL de l'image de l'avatar. Toujours présente. Il s'agit d'une image générée par défaut lorsque l'utilisateur n'a défini aucune photo.
> >
> > **username** `string` *required*
> >
> > Nom d'utilisateur public.
>
> **user\_id** `string` *required*
>
> ID de l'utilisateur

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

> [accordion] Propriétés
>
> **ban\_media** `boolean` *required*
>
> Empêche les membres de publier des médias.
>
> **ban\_urls** `boolean` *required*
>
> Empêche les membres de publier des liens.
>
> **banned\_words** `string[] | null` *required*
>
> Mots bloqués dans le canal. `null` lorsque vous ne pouvez pas consulter ce
> paramètre ; une liste vide signifie qu'aucun mot n'est bloqué.
>
> **user\_posts\_cooldown\_seconds** `integer | null` *required*
>
> Nombre de secondes qu'un membre doit attendre entre deux messages. `0` ou
> `null` désactive le délai.
>
> **who\_can\_post** `string` *required*
>
> Qui peut publier des messages.
>
> Options disponibles : `everyone`, `admins`
>
> **who\_can\_react** `string` *required*
>
> Qui peut réagir aux messages.
>
> Options disponibles : `everyone`, `no_one`

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

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

Indique si les notifications de l'app sont activées. Les webhooks se
déclenchent dans tous les cas.

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

> [accordion] Propriétés
>
> **awaiting\_reply** `boolean` *required*
>
> **customer\_user\_id** `string` *required*
>
> **last\_message\_by** `string | null` *required*
>
> Options disponibles : `customer`, `support`
>
> **resolved\_at** `string | null` *required*
>
> Date à laquelle la conversation de support a été résolue, sous forme
> d'horodatage ISO 8601. Null tant qu'elle n'est pas résolue.
>
> **status** `string` *required*
>
> Options disponibles : `unresolved`, `resolved`

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

Date de dernière modification du canal sous forme d'horodatage 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 Channel Members](https://docs.whop.com/fr/api-reference/channel-members/channel-member.md)
- [Delete Channel](https://docs.whop.com/fr/api-reference/channels/delete-channel.md)
- [Update Channel](https://docs.whop.com/fr/api-reference/channels/update-channel.md)
