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

# Messages API

> Een Message is één bericht in een channel. Het bevat Markdown-inhoud en kan bijlagen, een poll of een antwoord op een ander bericht bevatten.

Gebruik de Messages API om berichten te [versturen](https://docs.whop.com/nl/api-reference/messages/send-message.md), te [bewerken](https://docs.whop.com/nl/api-reference/messages/update-message.md), te [verwijderen](https://docs.whop.com/nl/api-reference/messages/delete-message.md) en vast te [pinnen](https://docs.whop.com/nl/api-reference/messages/pin-message.md). [Vraag de berichten van een channel op](https://docs.whop.com/nl/api-reference/messages/list-messages.md) om de geschiedenis te lezen en bewerkingen en verwijderingen te synchroniseren. Je kunt ook met een emoji [reageren](https://docs.whop.com/nl/api-reference/messages/react-to-message.md), [opvragen wie heeft gereageerd](https://docs.whop.com/nl/api-reference/messages/list-message-reactions.md) en eenmaal [stemmen](https://docs.whop.com/nl/api-reference/messages/vote-on-message.md) op een poll. Elk bericht toont het aantal reacties en stemmen en of jij hebt gereageerd of gestemd, maar niet wie er nog meer heeft gestemd.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Berichten opvragen](https://docs.whop.com/nl/api-reference/messages/list-messages.md) | GET `/messages` |
| [Bericht ophalen](https://docs.whop.com/nl/api-reference/messages/retrieve-message.md) | GET `/messages/{id}` |
| [Reacties op bericht opvragen](https://docs.whop.com/nl/api-reference/messages/list-message-reactions.md) | GET `/messages/{id}/reactions` |
| [Bericht versturen](https://docs.whop.com/nl/api-reference/messages/send-message.md) | POST `/messages` |
| [Bericht vastpinnen](https://docs.whop.com/nl/api-reference/messages/pin-message.md) | POST `/messages/{id}/pin` |
| [Reageren op bericht](https://docs.whop.com/nl/api-reference/messages/react-to-message.md) | POST `/messages/{id}/react` |
| [Bericht losmaken](https://docs.whop.com/nl/api-reference/messages/unpin-message.md) | POST `/messages/{id}/unpin` |
| [Reactie van bericht verwijderen](https://docs.whop.com/nl/api-reference/messages/remove-reaction-from-message.md) | POST `/messages/{id}/unreact` |
| [Stemmen op bericht](https://docs.whop.com/nl/api-reference/messages/vote-on-message.md) | POST `/messages/{id}/vote` |
| [Bericht bijwerken](https://docs.whop.com/nl/api-reference/messages/update-message.md) | PATCH `/messages/{id}` |
| [Bericht verwijderen](https://docs.whop.com/nl/api-reference/messages/delete-message.md) | DELETE `/messages/{id}` |

## Attributen

**id** `string` *required*

Message-ID, met prefix `post_`. Komt overeen met de `id` die bij het aanmaken is meegestuurd, als die is meegestuurd.

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

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die je teruggeeft aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De op 1 gebaseerde index van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die je met de upload-PUT meestuurt. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL, en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**author** `object | null` *required*

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> User-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

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

`true` als de auteur een teamlid is van het account dat eigenaar is van dit community-channel. `false` voor partners, privé- en supportchannels, en verwijderde berichten.

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

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

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

Markdown-inhoud. `null` voor een verwijderd bericht.

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

Aanmaaktijdstip als ISO 8601-tijdstempel.

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

> [accordion] Eigenschappen
>
> **display\_name** `string | null` *required*
>
> Weergavenaam van de webhook, of null om de naam van de gebruiker te gebruiken.
>
> **profile\_picture** `object | null` *required*
>
> Profielafbeelding van de webhook, of null om de afbeelding van de gebruiker te gebruiken.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > De ID van het bestand, met prefix `file_`.
> >
> > **blurhash** `string | null` *required*
> >
> > BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **content\_type** `string | null` *required*
> >
> > Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Blijft behouden wanneer moderatie het bestand verwijdert.
> >
> > **created\_at** `string` *required*
> >
> > Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
> >
> > **duration\_seconds** `number | null` *required*
> >
> > Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **filename** `string | null` *required*
> >
> > De oorspronkelijke bestandsnaam, inclusief extensie.
> >
> > **height** `integer | null` *required*
> >
> > Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **multipart\_chunk\_size** `integer | null`
> >
> > De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > **multipart\_upload\_id** `string | null`
> >
> > De ID van de multipart-upload, die je teruggeeft aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > **multipart\_upload\_urls** `object[] | null`
> >
> > De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
> >
> > > [accordion] Eigenschappen
> > >
> > > **part\_number** `integer` *required*
> > >
> > > De op 1 gebaseerde index van dit deel binnen de multipart-upload.
> > >
> > > **url** `string` *required*
> > >
> > > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
> >
> > **object** `string` *required*
> >
> > Het type van dit object, altijd `file`.
> >
> > **removed\_by\_moderation** `boolean` *required*
> >
> > Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
> >
> > **size** `integer | null` *required*
> >
> > De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
> >
> > **upload\_headers** `object`
> >
> > Headers die je met de upload-PUT meestuurt. Alleen aanwezig bij aanmaken.
> >
> > **upload\_status** `string` *required*
> >
> > Waar het bestand zich in de uploadlevenscyclus bevindt.
> >
> > Beschikbare opties: `pending`, `processing`, `ready`, `failed`
> >
> > **upload\_url** `string | null`
> >
> > Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
> >
> > **url** `string | null` *required*
> >
> > Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL, en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
> >
> > **visibility** `string` *required*
> >
> > `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
> >
> > Beschikbare opties: `public`, `private`
> >
> > **waveform\_url** `string | null` *required*
> >
> > URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
> >
> > **width** `integer | null` *required*
> >
> > Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

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

Tijdstip van verwijdering, of null voor een actief bericht.

**edited** `boolean` *required*

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

> [accordion] Eigenschappen
>
> **color** `integer | null` *required*
>
> **description** `string | null` *required*
>
> **fields** `object[]` *required*
>
> > [accordion] Eigenschappen
> >
> > **inline** `boolean` *required*
> >
> > **name** `string` *required*
> >
> > **value** `string` *required*
>
> **footer** `object | null` *required*
>
> Footer die onderaan de embed wordt getoond. Null wanneer de embed geen footer heeft.
>
> > [accordion] Eigenschappen
> >
> > **icon** `object | null` *required*
> >
> > Kleine afbeelding die naast de footertekst wordt getoond. Null wanneer de footer geen pictogram heeft.
> >
> > > [accordion] Eigenschappen
> > >
> > > **blurhash** `string | null` *required*
> > >
> > > **height** `integer | null` *required*
> > >
> > > **url** `string` *required*
> > >
> > > **width** `integer | null` *required*
> >
> > **text** `string` *required*
>
> **image** `object | null` *required*
>
> > [accordion] Eigenschappen
> >
> > **blurhash** `string | null` *required*
> >
> > **height** `integer | null` *required*
> >
> > **url** `string` *required*
> >
> > **width** `integer | null` *required*
>
> **thumbnail** `object | null` *required*
>
> > [accordion] Eigenschappen
> >
> > **blurhash** `string | null` *required*
> >
> > **height** `integer | null` *required*
> >
> > **url** `string` *required*
> >
> > **width** `integer | null` *required*
>
> **timestamp\_at** `string | null` *required*
>
> Tijdstip opgegeven door de auteur van de embed, als ISO 8601-tijdstempel in UTC. Null wanneer ontbrekend of ongeldig.
>
> **title** `string | null` *required*
>
> **url** `string | null` *required*

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

GIF's die aan het bericht zijn toegevoegd. Leeg voor een verwijderd bericht.

> [accordion] Eigenschappen
>
> **height** `integer` *required*
>
> Hoogte van `original_url`, in pixels.
>
> **original\_url** `string` *required*
>
> GIF op volledige grootte. HTTPS op een Klipy-mediahost.
>
> **preview\_url** `string` *required*
>
> Kleinere versie voor previews en placeholders. HTTPS op een Klipy-mediahost.
>
> **slug** `string` *required*
>
> Identificatie van de GIF.
>
> **title** `string` *required*
>
> Titel van de GIF.
>
> **url** `string` *required*
>
> URL waarvandaan het bericht de GIF rendert. HTTPS op een Klipy-mediahost.
>
> **width** `integer` *required*
>
> Breedte van `original_url`, in pixels.

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

> [accordion] Eigenschappen
>
> **description** `string | null` *required*
>
> Paginabeschrijving, of null zolang niet beschikbaar.
>
> **favicon\_url** `string | null` *required*
>
> URL van het sitepictogram, of null wanneer niet beschikbaar.
>
> **footer** `object | null` *required*
>
> Aanvullende previewinformatie, of null wanneer niet beschikbaar.
>
> > [accordion] Eigenschappen
> >
> > **description** `string | null` *required*
> >
> > **icon\_url** `string` *required*
> >
> > **title** `string` *required*
>
> **image\_url** `string | null` *required*
>
> URL van de previewafbeelding, of null wanneer niet beschikbaar.
>
> **processing** `boolean` *required*
>
> Of de server deze preview nog aan het genereren is.
>
> **title** `string | null` *required*
>
> Paginatitel, of null zolang niet beschikbaar.
>
> **url** `string` *required*
>
> URL waarvan een preview wordt gemaakt.

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

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

Beschikbare opties: `regular`, `system`, `automated`

**pinned** `boolean` *required*

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

Ongeformatteerde berichttekst. null wanneer de tekst ontbreekt of het bericht is verwijderd

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

> [accordion] Eigenschappen
>
> **options** `object[]` *required*
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Identificatie van de optie binnen de poll.
> >
> > **text** `string` *required*
> >
> > **vote\_count** `integer` *required*
> >
> > **voted** `boolean` *required*
> >
> > Of je op deze optie hebt gestemd.

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

> [accordion] Eigenschappen
>
> **kind** `string` *required*
>
> Beschikbare opties: `like`, `view`, `emoji`
>
> **reacted** `boolean` *required*
>
> Of je met deze waarde hebt gereageerd.
>
> **total\_score** `integer` *required*
>
> **user\_count** `integer` *required*
>
> **value** `string | null` *required*
>
> De Unicode-emoji voor een emojireactie. Voor andere soorten reacties de waarde van de reactie.

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

Het bericht waarop wordt gereageerd. Weggelaten tenzij `include_replying_to_message=true`. Bevat alle berichtvelden behalve `replying_to_message`. `null` wanneer dit bericht is verwijderd of er geen doel in hetzelfde channel bestaat.

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

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

User-ID van de auteur van het bericht waarop wordt gereageerd, met prefix `user_`. `null` zonder antwoord in dit channel, of wanneer een van beide berichten is verwijderd.

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

Laatste wijziging van het bericht als ISO 8601-tijdstempel.

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

Aantal weergaven van de experience. `null` voor channels op basis van DM'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
}
```
