Fanvue API Documentation

Engagement events fire when fans follow a creator or like and comment on their posts. creator.follow.created replaces the legacy follow.new event, and the post events have no legacy equivalent.

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

Each event arrives in the envelope, and the tables below describe data. For the same activity through the API, use Get followers and Get comments for a post.

Follow resource

creator.follow.created uses this resource. Follows have no external id, so 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

tracking carries { link_url, metadata } for the follower. The block is null when the follower carries neither a tracking parameter nor an impression on one of this creator’s links. link_url is the follower’s platform-wide last-touch parameter and metadata is scoped to this creator, so the two can disagree. Tracking links explains how creators set them up.

creator.follow.created fires on every created follow. The legacy follow.new stays behind the follow-notification throttle, so the two events don’t fire one-for-one. Don’t 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

creator.post.liked and creator.post.commented share this resource. A like has no external id (id is null), while 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.

Receiving events

Creator events

Checkout link events

App events

Legacy events (deprecated)

Creator engagement events

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`