Skip to main content

​
When this fires

Triggered when a user sends a tip to a creator. Amounts are in minor units (for USD, cents).

​
Payload

The payload uses a discriminated union pattern based on the context field:

​
Common fields

  • context: Either "post" or "message" - indicates the tip type
  • recipientUuid: UUID of the creator who received the tip
  • senderUuid: UUID of the user who sent the tip
  • price: Tip amount in minor units
  • sender: The user who tipped (uuid, handle, displayName, avatarUrl)
  • timestamp: ISO 8601 time the event occurred

​
Post tip fields

  • postUuid: UUID of the post that was tipped (only when context is "post")

​
Message tip fields

  • messageUuid: UUID of the message that was tipped (only when context is "message")

​
Example payloads

​
Post tip

{
  "context": "post",
  "postUuid": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
  "senderUuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
  "price": 500,
  "sender": {
    "avatarUrl": "https://via.placeholder.com/150",
    "displayName": "Test User",
    "handle": "test-user",
    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3"
  },
  "timestamp": "2025-11-06T10:32:52.000Z"
}

​
Message tip

{
  "context": "message",
  "messageUuid": "d4c3b2a1-6f5e-8b7a-0d9c-6d5c4b3a2f1e",
  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
  "senderUuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3",
  "price": 1000,
  "sender": {
    "avatarUrl": "https://via.placeholder.com/150",
    "displayName": "Test User",
    "handle": "test-user",
    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3"
  },
  "timestamp": "2025-11-06T10:32:52.000Z"
}