Message Received Webhook

​

When this fires

​

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

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