> ## Documentation Index
> Fetch the complete documentation index at: https://api.fanvue.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Creator Fan Status

> creator.fan.status_changed for fan mute/unmute and online/offline transitions.

`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](/creator/overview#event-envelope); the fields below
describe the `data` object.

<Note>
  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.
</Note>

## 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)

```json theme={null}
{
  "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)

```json theme={null}
{
  "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": {}
  }
}
```