Skip to main content

​
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

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

​
Message purchase

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