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

> creator.follow.created, creator.post.liked, and creator.post.commented engagement events.

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](/creator/overview#event-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         | `{ uuid, email }` of the follower (`email` may be `null`) |
| `creator`    | object         | `{ uuid }` of the creator                                 |
| `metadata`   | object         | Your passthrough metadata map                             |

### Example: `creator.follow.created`

```json theme={null}
{
  "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": "fan@example.com" },
    "creator": { "uuid": "creator-uuid" },
    "metadata": {}
  }
}
```

## 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         | `{ uuid }` of the user who liked or commented |
| `creator`      | object         | `{ uuid }` of the creator who owns the post   |
| `created_at`   | string \| null | ISO 8601 time the like/comment occurred       |
| `metadata`     | object         | Your passthrough metadata map                 |

### Example: `creator.post.commented`

```json theme={null}
{
  "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" },
    "creator": { "uuid": "creator-uuid" },
    "created_at": "2026-06-09T08:39:33.139Z",
    "metadata": {}
  }
}
```

For `creator.post.liked` the same shape is used with `id: null` and
`comment_text: null`.