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	The follower, see Purchaser. `email` is always `null`
`creator`	object	`{ uuid }` of the creator
`metadata`	object	Reserved; always `{}` on this event
`tracking`	object \| null	Tracking-link attribution for the follower, see Tracking

creator.follow.created fires on every created follow. The legacy follow.new stays behind the follow-notification throttle, so the two events do not fire one-for-one; do not treat a missing follow.new as a missing follow.

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": null,
      "handle": "janed",
      "display_name": "Jane D"
    },
    "creator": { "uuid": "creator-uuid" },
    "metadata": {},
    "tracking": {
      "link_url": "https://fanvue.com/creator-handle?fvc=summer-campaign",
      "metadata": { "campaign": "summer", "source": "x" }
    }
  }
}

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	Who liked or commented, see Purchaser. `email` is always `null`
`creator`	object	`{ uuid }` of the creator who owns the post
`created_at`	string \| null	ISO 8601 time the like/comment occurred
`metadata`	object	Reserved; always `{}` on this event

The post events carry no tracking block.

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",
      "email": null,
      "handle": "janed",
      "display_name": "Jane D"
    },
    "creator": { "uuid": "creator-uuid" },
    "created_at": "2026-06-09T08:39:33.139Z",
    "metadata": {}
  }
}

creator.post.liked uses the same shape with id: null and comment_text: null.

Overview

Creator events

Checkout

App webhooks

Legacy events (deprecated)

Creator Engagement

Follow resource

Example: `creator.follow.created`

Post resource

Example: `creator.post.commented`

​Follow resource

​Example: creator.follow.created

​Post resource

​Example: creator.post.commented

Follow resource

Example: `creator.follow.created`

Post resource

Example: `creator.post.commented`