Webhooks

Message Received Webhook

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, createdAt)
  • 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
  • timestamp: ISO 8601 time the event occurred

Example payload

1{
2  "message": {
3    "uuid": "2f7c5e8a-6d36-4e3a-98d9-9f1b3b0a1a10",
4    "text": "Hey! Is this still available?",
5    "hasMedia": false,
6    "createdAt": "2025-11-06T10:32:48.100Z"
7  },
8  "messageUuid": "2f7c5e8a-6d36-4e3a-98d9-9f1b3b0a1a10",
9  "sender": {
10    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
11    "handle": "test-user",
12    "displayName": "Test User",
13    "avatarUrl": "https://via.placeholder.com/150"
14  },
15  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
16  "timestamp": "2025-11-06T10:32:49.880Z"
17}