Webhooks

Tip Received Webhook

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

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

Message tip

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