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

> Un Message est une publication dans un canal. Il contient du contenu Markdown et peut comporter des pièces jointes, un sondage ou une réponse à un autre message.

Utilisez l'API Messages pour [envoyer](https://docs.whop.com/fr/api-reference/messages/send-message.md), [modifier](https://docs.whop.com/fr/api-reference/messages/update-message.md), [supprimer](https://docs.whop.com/fr/api-reference/messages/delete-message.md) et [épingler](https://docs.whop.com/fr/api-reference/messages/pin-message.md) des messages. [Listez les messages d'un canal](https://docs.whop.com/fr/api-reference/messages/list-messages.md) pour lire son historique et synchroniser les modifications et suppressions. Vous pouvez également [réagir](https://docs.whop.com/fr/api-reference/messages/react-to-message.md) avec un emoji, [lister qui a réagi](https://docs.whop.com/fr/api-reference/messages/list-message-reactions.md) et [voter](https://docs.whop.com/fr/api-reference/messages/vote-on-message.md) une fois dans un sondage. Chaque message indique ses nombres de réactions et de votes et si vous avez réagi ou voté, mais pas qui d'autre a voté.

## Endpoints

| Endpoint | Requête |
| - | - |
| [Lister les messages](https://docs.whop.com/fr/api-reference/messages/list-messages.md) | GET `/messages` |
| [Récupérer un message](https://docs.whop.com/fr/api-reference/messages/retrieve-message.md) | GET `/messages/{id}` |
| [Lister les réactions à un message](https://docs.whop.com/fr/api-reference/messages/list-message-reactions.md) | GET `/messages/{id}/reactions` |
| [Envoyer un message](https://docs.whop.com/fr/api-reference/messages/send-message.md) | POST `/messages` |
| [Épingler un message](https://docs.whop.com/fr/api-reference/messages/pin-message.md) | POST `/messages/{id}/pin` |
| [Réagir à un message](https://docs.whop.com/fr/api-reference/messages/react-to-message.md) | POST `/messages/{id}/react` |
| [Désépingler un message](https://docs.whop.com/fr/api-reference/messages/unpin-message.md) | POST `/messages/{id}/unpin` |
| [Retirer une réaction d'un message](https://docs.whop.com/fr/api-reference/messages/remove-reaction-from-message.md) | POST `/messages/{id}/unreact` |
| [Voter sur un message](https://docs.whop.com/fr/api-reference/messages/vote-on-message.md) | POST `/messages/{id}/vote` |
| [Mettre à jour un message](https://docs.whop.com/fr/api-reference/messages/update-message.md) | PATCH `/messages/{id}` |
| [Supprimer un message](https://docs.whop.com/fr/api-reference/messages/delete-message.md) | DELETE `/messages/{id}` |

## Attributs

**id** `string` *required*

ID du message, préfixé par `post_`. Correspond à l'`id` envoyé lors de la création, lorsqu'un id a été
envoyé.

**attachments** `object[]` *required*

> [accordion] Propriétés
>
> **id** `string` *required*
>
> L'ID du fichier, préfixé par `file_`.
>
> **blurhash** `string | null` *required*
>
> Aperçu BlurHash d'une image ou d'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 téléversements en plusieurs parties.
>
> **multipart\_upload\_id** `string | null`
>
> L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement lors de la
> création, et uniquement pour les téléversements en plusieurs parties.
>
> **multipart\_upload\_urls** `object[] | null`
>
> L'URL présignée de chaque partie. Présente uniquement lors de la création, et uniquement pour les téléversements en plusieurs parties.
>
> > [accordion] Propriétés
> >
> > **part\_number** `integer` *required*
> >
> > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> >
> > **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 la valeur est `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 le téléversement n'est pas terminé.
>
> **upload\_headers** `object`
>
> En-têtes à envoyer avec la requête PUT de téléversement. Présent uniquement lors de la création.
>
> **upload\_status** `string` *required*
>
> L'étape où se trouve le fichier dans son cycle de téléversement.
>
> Options disponibles : `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement lors de la création, et uniquement pour
> les téléversements 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 le téléversement n'est pas terminé.
> 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.

**author** `object | null` *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ésent, 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.

**author\_is\_team\_member** `boolean` *required*

`true` si l'auteur est membre de l'équipe du compte propriétaire de ce canal
communautaire. `false` pour les partenaires, les canaux privés et de support, et les messages
supprimés.

**author\_user\_id** `string | null` *required*

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

**content** `string | null` *required*

Contenu Markdown. `null` pour un message supprimé.

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

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

**custom\_author** `object | null` *required*

> [accordion] Propriétés
>
> **display\_name** `string | null` *required*
>
> Nom d'affichage du webhook, ou null pour utiliser le nom de l'utilisateur.
>
> **profile\_picture** `object | null` *required*
>
> Image de profil du webhook, ou null pour utiliser l'image de l'utilisateur.
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > L'ID du fichier, préfixé par `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > Aperçu BlurHash d'une image ou d'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 téléversements en plusieurs parties.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > L'ID du téléversement en plusieurs parties, à renvoyer à `complete`. Présent uniquement lors de la
> > création, et uniquement pour les téléversements en plusieurs parties.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > L'URL présignée de chaque partie. Présente uniquement lors de la création, et uniquement pour les téléversements en plusieurs parties.
> >
> > > [accordion] Propriétés
> > >
> > > **part\_number** `integer` *required*
> > >
> > > L'index (à partir de 1) de cette partie dans le téléversement en plusieurs parties.
> > >
> > > **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 la valeur est `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 le téléversement n'est pas terminé.
> >
> > **upload\_headers** `object`
> >
> > En-têtes à envoyer avec la requête PUT de téléversement. Présent uniquement lors de la création.
> >
> > **upload\_status** `string` *required*
> >
> > L'étape où se trouve le fichier dans son cycle de téléversement.
> >
> > Options disponibles : `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > URL présignée vers laquelle envoyer (PUT) les octets du fichier. Présente uniquement lors de la création, et uniquement pour
> > les téléversements 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 le téléversement n'est pas terminé.
> > 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.

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

Date de suppression, ou null pour un message actif.

**edited** `boolean` *required*

**embeds** `object[]` *required*

> [accordion] Propriétés
>
> **color** `integer | null` *required*
>
> **description** `string | null` *required*
>
> **fields** `object[]` *required*
>
> > [accordion] Propriétés
> >
> > **inline** `boolean` *required*
> >
> > **name** `string` *required*
> >
> > **value** `string` *required*
>
> **footer** `object | null` *required*
>
> Pied de page affiché en bas de l'embed. Null lorsque l'embed n'a pas de pied de page.
>
> > [accordion] Propriétés
> >
> > **icon** `object | null` *required*
> >
> > Petite image affichée à côté du texte du pied de page. Null lorsque le pied de page n'a pas d'icône.
> >
> > > [accordion] Propriétés
> > >
> > > **blurhash** `string | null` *required*
> > >
> > > **height** `integer | null` *required*
> > >
> > > **url** `string` *required*
> > >
> > > **width** `integer | null` *required*
> >
> > **text** `string` *required*
>
> **image** `object | null` *required*
>
> > [accordion] Propriétés
> >
> > **blurhash** `string | null` *required*
> >
> > **height** `integer | null` *required*
> >
> > **url** `string` *required*
> >
> > **width** `integer | null` *required*
>
> **thumbnail** `object | null` *required*
>
> > [accordion] Propriétés
> >
> > **blurhash** `string | null` *required*
> >
> > **height** `integer | null` *required*
> >
> > **url** `string` *required*
> >
> > **width** `integer | null` *required*
>
> **timestamp\_at** `string | null` *required*
>
> Date fournie par l'auteur de l'embed, sous forme d'horodatage ISO 8601 en UTC. Null lorsqu'elle est
> absente ou invalide.
>
> **title** `string | null` *required*
>
> **url** `string | null` *required*

**gifs** `object[]` *required*

GIF joints au message. Vide pour un message supprimé.

> [accordion] Propriétés
>
> **height** `integer` *required*
>
> Hauteur de `original_url`, en pixels.
>
> **original\_url** `string` *required*
>
> GIF en taille réelle. HTTPS sur un hôte média Klipy.
>
> **preview\_url** `string` *required*
>
> Version réduite pour les aperçus et espaces réservés. HTTPS sur un hôte média Klipy.
>
> **slug** `string` *required*
>
> Identifiant du GIF.
>
> **title** `string` *required*
>
> Titre du GIF.
>
> **url** `string` *required*
>
> URL depuis laquelle le message affiche le GIF. HTTPS sur un hôte média Klipy.
>
> **width** `integer` *required*
>
> Largeur de `original_url`, en pixels.

**link\_previews** `object[]` *required*

> [accordion] Propriétés
>
> **description** `string | null` *required*
>
> Description de la page, ou null tant qu'elle n'est pas disponible.
>
> **favicon\_url** `string | null` *required*
>
> URL de l'icône du site, ou null lorsqu'elle n'est pas disponible.
>
> **footer** `object | null` *required*
>
> Informations d'aperçu supplémentaires, ou null lorsqu'elles ne sont pas disponibles.
>
> > [accordion] Propriétés
> >
> > **description** `string | null` *required*
> >
> > **icon\_url** `string` *required*
> >
> > **title** `string` *required*
>
> **image\_url** `string | null` *required*
>
> URL de l'image d'aperçu, ou null lorsqu'elle n'est pas disponible.
>
> **processing** `boolean` *required*
>
> Indique si le serveur est encore en train de générer cet aperçu.
>
> **title** `string | null` *required*
>
> Titre de la page, ou null tant qu'il n'est pas disponible.
>
> **url** `string` *required*
>
> URL dont l'aperçu est affiché.

**mentioned\_user\_ids** `string[]` *required*

**message\_type** `string` *required*

Options disponibles : `regular`, `system`, `automated`

**pinned** `boolean` *required*

**plain\_content** `string | null` *required*

Texte du message non formaté. null lorsque le texte est absent ou que le message est
supprimé

**poll** `object | null` *required*

> [accordion] Propriétés
>
> **options** `object[]` *required*
>
> > [accordion] Propriétés
> >
> > **id** `string` *required*
> >
> > Identifiant de l'option dans le sondage.
> >
> > **text** `string` *required*
> >
> > **vote\_count** `integer` *required*
> >
> > **voted** `boolean` *required*
> >
> > Indique si vous avez voté pour cette option.

**reaction\_counts** `object[]` *required*

> [accordion] Propriétés
>
> **kind** `string` *required*
>
> Options disponibles : `like`, `view`, `emoji`
>
> **reacted** `boolean` *required*
>
> Indique si vous avez réagi avec cette valeur.
>
> **total\_score** `integer` *required*
>
> **user\_count** `integer` *required*
>
> **value** `string | null` *required*
>
> L'emoji Unicode pour une réaction emoji. Pour les autres types de réaction, la valeur de la réaction.

**replying\_to\_message** `object | null`

Le message auquel il est répondu. Omis sauf si `include_replying_to_message=true`.
Inclut tous les champs du message sauf `replying_to_message`. `null` lorsque ce
message est supprimé ou qu'aucune cible n'existe dans le même canal.

**replying\_to\_message\_id** `string | null` *required*

**replying\_to\_user\_id** `string | null` *required*

ID de l'utilisateur auteur du message auquel il est répondu, préfixé par `user_`. `null` en l'absence de
réponse dans ce canal, ou lorsque l'un des deux messages est supprimé.

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

Date de la dernière modification du message sous forme d'horodatage ISO 8601.

**view\_count** `integer | null` *required*

Nombre de vues de l'expérience. `null` pour les canaux de messages privés.

```json ChatMessage theme={null}
{
	"id": "post_xxxxxxxxxxxxxxxxxxxxxx",
	"channel_id": "feed_xxxxxxxxxxxxxxxxxxxxxx",
	"author_user_id": "user_yyyyyyyyyyyyyy",
	"author": {
		"id": "user_yyyyyyyyyyyyyy",
		"username": "marcusreed",
		"name": "Marcus Reed",
		"profile_picture": {
			"url": "https://img.whop.com/avatars/user_yyyyyyyyyyyyyy.png"
		}
	},
	"author_is_team_member": true,
	"custom_author": null,
	"content": "Which coating should we test on the demo car this Saturday? **Vote below.** Booking page: https://shinetime.example/book",
	"plain_content": "Which coating should we test on the demo car this Saturday? Vote below. Booking page: https://shinetime.example/book",
	"message_type": "regular",
	"edited": false,
	"pinned": true,
	"replying_to_message_id": null,
	"replying_to_user_id": null,
	"attachments": [
		{
			"id": "file_yyyyyyyyyyyyyy",
			"object": "file",
			"filename": "demo-car.jpg",
			"content_type": "image/jpeg",
			"size": 284190,
			"url": "https://img.whop.com/uploads/demo-car.jpg",
			"removed_by_moderation": false,
			"upload_status": "ready",
			"visibility": "public",
			"created_at": "2026-09-02T16:20:11.000Z",
			"width": 1600,
			"height": 1067,
			"blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
			"duration_seconds": null,
			"waveform_url": null
		}
	],
	"poll": {
		"options": [
			{
				"id": "1",
				"text": "Graphene",
				"vote_count": 14,
				"voted": true
			},
			{
				"id": "2",
				"text": "Ceramic",
				"vote_count": 9,
				"voted": false
			}
		]
	},
	"mentioned_user_ids": [],
	"link_previews": [
		{
			"url": "https://shinetime.example/book",
			"title": "Book a detail | Shine Time",
			"description": "Pick a bay and a time for your next detail.",
			"image_url": "https://shinetime.example/og.png",
			"favicon_url": "https://shinetime.example/favicon.ico",
			"processing": false,
			"footer": {
				"title": "shinetime.example",
				"description": null,
				"icon_url": "https://shinetime.example/favicon.ico"
			}
		}
	],
	"gifs": [
		{
			"slug": "car-wash-shine-xxxxxxxx",
			"title": "Car Wash Shine",
			"url": "https://media.giphy.com/media/xxxxxxxx/giphy.gif",
			"original_url": "https://media.giphy.com/media/xxxxxxxx/giphy.gif",
			"preview_url": "https://media.giphy.com/media/xxxxxxxx/200w.gif",
			"width": 480,
			"height": 270
		}
	],
	"embeds": [
		{
			"color": 3447003,
			"title": "Saturday demo day",
			"url": "https://shinetime.example/demo",
			"description": "Live coating demo at Bay 2, 10:00 AM.",
			"timestamp_at": "2026-10-18T15:00:00.000Z",
			"thumbnail": {
				"url": "https://img.whop.com/uploads/demo-car-thumb.jpg",
				"width": 320,
				"height": 213,
				"blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj"
			},
			"image": null,
			"footer": {
				"text": "Shine Time Auto Detailing",
				"icon": null
			},
			"fields": [
				{
					"name": "Location",
					"value": "Bay 2",
					"inline": true
				},
				{
					"name": "Time",
					"value": "10:00 AM",
					"inline": true
				}
			]
		}
	],
	"reaction_counts": [
		{
			"kind": "emoji",
			"value": "🔥",
			"user_count": 6,
			"total_score": 6,
			"reacted": false
		}
	],
	"view_count": 182,
	"created_at": "2026-10-14T09:12:40.000Z",
	"updated_at": "2026-10-14T09:12:40.000Z",
	"deleted_at": null
}
```
