Fanvue API Documentation

follow.new is the deprecated flat event for a user following a creator. It requires the read:creator scope, and new integrations use creator.follow.created instead.

Don’t build new integrations on follow.new. It keeps firing during the migration window, after which only creator.follow.created is delivered. Subscribe to creator.follow.created and move existing consumers before the window closes.

When this fires

follow.new fires when a user follows a creator.

Payload

Field	Description
`recipientUuid`	UUID of the creator who was followed
`sender`	The user who followed (uuid, handle, displayName, avatarUrl)
`trackingLinkId`	The tracking link the follower arrived through. Omitted when the follower has no tracking link attribution
`trackingLinkUrl`	The same value as `trackingLinkId`. Omitted together with it
`trackingLinkMetadata`	The per-user metadata captured on that tracking link for this creator, as a string map. Omitted when none was captured
`timestamp`	ISO 8601 time the event occurred

The tracking fields are attribution for the follower, resolved at emission time, and match the tracking block on creator.follow.created. Tracking links explains how the attribution is captured.

Example payload

{
  "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"
  },
  "trackingLinkId": "spring-promo",
  "trackingLinkUrl": "spring-promo",
  "trackingLinkMetadata": { "source": "instagram" },
  "timestamp": "2025-11-06T10:32:49.880Z"
}