Fanvue API Documentation

creator.fan.status_changed fires when a fan’s status relative to the creator changes. It is a new event with no legacy flat equivalent. The change_type field discriminates what changed:

mute: the creator muted or unmuted the fan (state is muted / unmuted).
presence: the fan came online or went offline (state is online / offline).

Requires the read:chat scope. Delivered in the Standard-Webhooks envelope; the fields below describe the data object.

Presence changes are high-volume and delivered only to connector destinations that opt in; they may not be enabled in every environment. Mute changes fire on every creator mute/unmute action.

Fan status resource

Field	Type	Description
`object`	string	Always `"fan_status"`
`change_type`	string	`mute` or `presence`
`state`	string	`muted` \| `unmuted` (for `mute`), or `online` \| `offline` (for `presence`)
`changed_at`	string \| null	ISO 8601 time the change occurred
`fan`	object	`{ uuid, email }` of the fan (`email` may be `null`)
`creator`	object	`{ uuid }` of the creator
`metadata`	object	Your passthrough metadata map

Example: `creator.fan.status_changed` (mute)

{
  "id": "f1a2b3c4-bbbb-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "creator.fan.status_changed",
  "timestamp": "2026-06-09T08:39:33.139Z",
  "data": {
    "object": "fan_status",
    "change_type": "mute",
    "state": "muted",
    "changed_at": "2026-06-09T08:39:33.139Z",
    "fan": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": {}
  }
}

Example: `creator.fan.status_changed` (presence)

{
  "id": "f1a2b3c4-cccc-4a2b-9c3d-aaaaaaaaaaaa",
  "type": "creator.fan.status_changed",
  "timestamp": "2026-06-09T08:39:33.139Z",
  "data": {
    "object": "fan_status",
    "change_type": "presence",
    "state": "online",
    "changed_at": "2026-06-09T08:39:33.139Z",
    "fan": { "uuid": "fan-uuid", "email": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": {}
  }
}

⌘I