Update a creator's notes about a fan

Changed on

Replaces the specified creator's notes about a fan on their behalf and returns the stored result.

These are the notes the creator keeps on a fan in the Fanvue chat sidebar and contact list. Only the manually written notes are exposed; automatically generated fan summaries are never returned. Notes do not require an existing conversation with the fan.

The body replaces the notes in full, so send the complete text rather than a delta. Pass null (or an empty string) to clear them. Returns 400 if userUuid is the creator's own UUID and 404 if the user does not exist.

put/creators/{creatorUserUuid}/chats/{userUuid}/notes

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/chats/{userUuid}/notes
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:chat, read:creator

Path parameters

creatorUserUuidstring uuid required
userUuidstring uuid required

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

notesstring nullable required

The full replacement notes (max 5000 characters). Pass null or an empty string to clear them.

Response

The stored notes

notesstring nullable required

The notes kept about this fan, or null when none have been written. Only the manually written notes are returned; automatically generated summaries are never included.

updatedAtstring date-time nullable required

When the notes were last changed, or null when no notes are stored. The timestamp belongs to the fan's customisation record, so other changes to that record, including a nickname edit or internal updates, also move it.

Changes