Message Read Webhook

When this fires

Triggered when a creator marks messages from a user as read.

Payload

  • counterpartUuid: UUID of the user whose messages were marked as read
  • readMessagesCount: Number of messages that were marked as read
  • recipientUuid: UUID of the creator who read the messages
  • timestamp: ISO 8601 time the event occurred

Example payload

1{
2 "counterpartUuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
3 "readMessagesCount": 5,
4 "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
5 "timestamp": "2025-11-06T10:32:52.000Z"
6}

Usage

Use readMessagesCount to update local unread message counts without needing to call the /unread endpoint. When you receive this event, subtract readMessagesCount from your cached unread count for the given counterpartUuid.