Fanvue API Documentation

message.received is the deprecated flat event for a new fan message in a creator’s inbox. It requires the read:chat scope, and new integrations use creator.message.received instead.

Don’t build new integrations on message.received. It keeps firing during the migration window, after which only creator.message.received is delivered. Subscribe to creator.message.received and move existing consumers before the window closes.

When this fires

message.received fires when a new direct message arrives in a creator’s inbox.

Payload

Field	Description
`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 USD 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

{
  "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"
}