Webhooks

Purchase Received Webhook

When this fires

Triggered when a user purchases a paid post or piece of content from a creator.

Amounts are in minor units (for USD, cents).

Payload

  • postUuid: UUID of the purchased post/content (included if the purchase was for a post)
  • routeUuid: UUID of the purchased message (included if the purchase was for a message)
  • price: Purchase amount in minor units
  • recipientUuid: UUID of the creator who received the purchase
  • sender: The user who purchased (uuid, handle, displayName, avatarUrl)
  • timestamp: ISO 8601 time the event occurred

Example payloads

Post purchase

1{
2  "postUuid": "217d5dc9-cae0-4c09-b643-2e3aa498587a",
3  "price": 2499,
4  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
5  "sender": {
6    "avatarUrl": "https://via.placeholder.com/150",
7    "displayName": "Test User",
8    "handle": "test-user",
9    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3"
10  },
11  "timestamp": "2025-11-06T10:32:51.259Z"
12}

Message purchase

1{
2  "routeUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
3  "price": 1999,
4  "recipientUuid": "f4b2a184-2b4a-4a04-9b70-3c0e0a1caa12",
5  "sender": {
6    "avatarUrl": "https://via.placeholder.com/150",
7    "displayName": "Test User",
8    "handle": "test-user",
9    "uuid": "5939ae62-3eb5-4433-954f-f78c7b4282f3"
10  },
11  "timestamp": "2025-11-06T10:32:51.259Z"
12}