> ## Documentation Index
> Fetch the complete documentation index at: https://api.fanvue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Message Received Webhook

> Webhook event fired when a creator receives a new message.

<Warning>
  `message.received` is deprecated. Use
  [`creator.message.received`](/docs/creator/messages) instead. This event continues
  to fire during the migration window; new integrations should use the
  `creator.*` event.
</Warning>

## When this fires

Triggered when a new direct message is received in a creator's inbox.

## Payload

* `message`: Details of the message (uuid, text, hasMedia, mediaUuids, price, createdAt). `mediaUuids` is the ordered list of media UUIDs attached to the message (display order); `price` is in cents for pay-to-view messages.
* `messageUuid`: Unique identifier for the message
* `sender`: The user who sent the message (uuid, handle, displayName, avatarUrl)
* `recipientUuid`: UUID of the creator who received the message
* `unreadMessagesCount`: The recipient's unread message count for that conversation, including the message that triggered this event
* `isMuted`: Whether the recipient has muted the sender
* `timestamp`: ISO 8601 time the event occurred

## Example payload

```json theme={null}
{
  "message": {
    "uuid": "2f7c5e8a-6d36-4e3a-98d9-9f1b3b0a1a10",
    "text": "Hey! Is this still available?",
    "hasMedia": true,
    "mediaUuids": ["b8c47a91-3f2d-4a55-b7e8-1c9d2e4f5a6b"],
    "price": 300,
    "createdAt": "2026-05-20T08:39:33.139Z"
  },
  "messageUuid": "2f7c5e8a-6d36-4e3a-98d9-9f1b3b0a1a10",
  "sender": {
    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
    "handle": "test-user",
    "displayName": "Test User",
    "avatarUrl": "https://via.placeholder.com/150"
  },
  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
  "unreadMessagesCount": 3,
  "isMuted": false,
  "timestamp": "2026-05-20T08:39:33.310Z"
}
```