Fanvue API Documentation

These events fire when fans engage with a creator’s profile and posts. creator.follow.created is the successor to the legacy follow.new event; the post events are new.

Event (`type`)	`data.object`	Scope	Fires when
`creator.follow.created`	follow	`read:creator`	A user follows the creator
`creator.post.liked`	post	`read:post`	A user likes one of the creator’s posts
`creator.post.commented`	post	`read:post`	A user comments on one of the creator’s posts

Delivered in the Standard-Webhooks envelope; the fields below describe the data object.

Follow resource

Used by creator.follow.created. Follows have no external id — the identity is the (follower, creator) pair.

Field	Type	Description
`object`	string	Always `"follow"`
`id`	string \| null	Always `null` (follows have no external id)
`created_at`	string \| null	ISO 8601 time the follow occurred
`follower`	object	`{ uuid, email }` of the follower (`email` may be `null`)
`creator`	object	`{ uuid }` of the creator
`metadata`	object	Your passthrough metadata map

Example: `creator.follow.created`

{
  "id": "f1a2b3c4-7777-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "creator.follow.created",
  "timestamp": "2026-06-09T08:39:33.139Z",
  "data": {
    "object": "follow",
    "id": null,
    "created_at": "2026-06-09T08:39:33.139Z",
    "follower": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": {}
  }
}

Post resource

Used by creator.post.liked and creator.post.commented. A like has no external id (id is null); a comment carries its own uuid in id and its text in comment_text.

Field	Type	Description
`object`	string	Always `"post"`
`id`	string \| null	The comment’s uuid; `null` for likes
`post_uuid`	string	The post that was liked or commented on
`comment_text`	string \| null	The comment body; `null` for likes
`actor`	object	`{ uuid }` of the user who liked or commented
`creator`	object	`{ uuid }` of the creator who owns the post
`created_at`	string \| null	ISO 8601 time the like/comment occurred
`metadata`	object	Your passthrough metadata map

Example: `creator.post.commented`

{
  "id": "f1a2b3c4-8888-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "creator.post.commented",
  "timestamp": "2026-06-09T08:39:33.139Z",
  "data": {
    "object": "post",
    "id": "c0mment-uuid",
    "post_uuid": "217d5dc9-cae0-4c09-b643-2e3aa498587a",
    "comment_text": "Love this!",
    "actor": { "uuid": "fan-uuid" },
    "creator": { "uuid": "creator-uuid" },
    "created_at": "2026-06-09T08:39:33.139Z",
    "metadata": {}
  }
}

For creator.post.liked the same shape is used with id: null and comment_text: null.

⌘I