---
title: Fanvue API Integration on Truto
slug: fanvue
category: Subscription Platform
canonical: "https://truto.one/integrations/detail/fanvue/"
---

# Fanvue API Integration on Truto



**Category:** Subscription Platform  
**Status:** Generally available

## MCP-ready AI tools

Truto exposes 225 tools for Fanvue that AI agents can call directly.

- **list_all_fanvue_agencies_team_members** — List all team members in the authenticated user's fanvue agency. Returns: uuid, isAdmin, email, displayName, nickname, and creatorAccess (array of creator UUIDs and their assigned roles).
- **update_a_fanvue_agencies_team_member_by_id** — Update a fanvue agency team member's properties such as nickname or creator access assignments. Returns: uuid, isAdmin, email, displayName, nickname, and creatorAccess. Required: id, creatorUuids.
- **create_a_fanvue_agencies_invite** — Invite a new team member to the authenticated user's fanvue agency by email. Returns: success, message, inviteUuid. Required: email. The invited user must have an existing account, must not be a creator, and must not already be invited to this agency.
- **create_a_fanvue_agencies_creator_invite** — Invite a creator to connect to the authenticated agency in Fanvue by email. The invited user must have an existing Fanvue creator account; an invitation email with an acceptance link will be sent to them. Returns: success, message. Required: email.
- **list_all_fanvue_insights_chatter_leaderboards** — List per-chatter performance metrics for the authenticated agency over a specified time period, sorted by revenue descending. Returns: chatterUuid, chatterName, messages, ppvsSent, ppvsUnlocked, revenue, goldenRatio, unlockRatio, activeHours, eph, and avgResponseMs. Stats are refreshed at most once per day.
- **list_all_fanvue_agencies_chats** — List fanvue chats across all agency-managed creators in a single paginated stream, sorted by most recent activity. Returns: createdAt, lastMessageAt, isRead, isMuted, unreadMessagesCount, user (uuid, handle, displayName, isTopSpender), lastMessage (uuid, text, type, sentAt, hasMedia, mediaType, senderUuid, sentByUserId), and creatorUuid per chat row.
- **list_all_fanvue_agencies_subscribers** — List active fanvue subscribers across all agency-managed creators, sorted by most recent subscription first. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt, creatorUuid, subscribedAt, expiresAt. Optionally restrict results to specific creators using creatorUuids (max 50 UUIDs).
- **list_all_fanvue_agencies_earnings** — List per-creator-per-day earnings across all fanvue agency-managed creators, sorted by most recent day first. Only paid earning invoices are included; gross and net figures are in USD cents. Returns: creatorUuid, date, gross, net, currency. Required: startDate, endDate.
- **list_all_fanvue_agencies_subscribers_histories** — List per-creator-per-day subscriber event rows across all fanvue agency-managed creators, sorted by most recent day first. Returns: creatorUuid, date, total, newSubscribersCount, cancelledSubscribersCount, renewalOnCount, renewalOffCount, freeTrialCount, expiredCount. Required: startDate, endDate. Date range must not exceed 365 days.
- **list_all_fanvue_agencies_followers_histories** — List per-creator-per-day new-follower counts across all fanvue agency-managed creators, sorted by most recent day first. Returns: creatorUuid, date, newFollowersCount, total. Required: startDate, endDate. Date range must not exceed 365 days.
- **list_all_fanvue_app_subscription_status** — Get the pricing plan subscription lifecycle status for a fanvue developer-owned app. Returns: appUuid, appName, availability, overallStatus, and pricingPlans (each with uuid, name, billingType, interval, price, currencyCode, and status). Required: app_uuid.
- **get_single_fanvue_app_subscription_by_id** — Get the current authenticated user's subscription entitlement for a fanvue app. Returns: appUuid, userUuid, hasActiveSubscription, status, planUuid, planName, currentPeriodEnd, cancelAtPeriodEnd, and managedCreators (for agency team members, an array of per-creator subscription states; empty for non-agency users). Required: app_uuid.
- **list_all_fanvue_chats** — List fanvue chat conversations with optional filtering, searching, and sorting. Returns: createdAt, lastMessageAt, isRead, isMuted, unreadMessagesCount, user, lastMessage.
- **create_a_fanvue_chat** — Create a new fanvue chat conversation with a specified user. Returns: message. Required: userUuid.
- **fanvue_chats_list_messages** — List messages from a fanvue chat conversation with a specific user, ordered by creation date (newest first). Returns: uuid, text, sentAt, sender, recipient, hasMedia, mediaType, mediaUuids, type, pricing, purchasedAt, sentByUserId, isRead. Required: user_uuid.
- **update_a_fanvue_chat_by_id** — Update properties of a fanvue chat conversation such as read status, mute status, or nickname. Returns an empty 204 response on success. Required: id.
- **create_a_fanvue_chat_message** — Send a message to a fanvue user in an existing chat conversation. The message can include text, media attachments, and optional pricing for pay-to-view content. Returns: messageUuid. Required: user_uuid.
- **delete_a_fanvue_chat_message_by_id** — Delete/unsend a previously sent fanvue message from a chat conversation. Only the sender can delete their own messages; purchased content and mass messages cannot be deleted. Returns an empty 204 response on success. Required: user_uuid, id.
- **fanvue_chat_messages_create_2** — Send a message as a creator in an existing fanvue chat conversation. The message can include text, media attachments, and optional pricing for pay-to-view content. Returns: messageUuid. Required: creator_user_uuid, user_uuid.
- **fanvue_chat_messages_delete_2** — Delete/unsend a previously sent message from a fanvue creator's chat conversation. Only messages sent by the creator can be deleted; purchased content and mass messages cannot be deleted. Returns an empty 204 response on success. Required: creator_user_uuid, user_uuid, message_uuid.
- **list_all_fanvue_chats_mass_messages** — List fanvue mass (broadcast) messages sent by the authenticated creator, with delivery and engagement statistics per message. Returns: uuid, status, text, price, recipientCount, viewCount, purchaseCount, totalRevenue, scheduledAt, publishedAt, createdAt, mediaUuids, includedLists, excludedLists.
- **create_a_fanvue_chats_mass_message** — Send a fanvue mass message to multiple users based on selected recipient lists. Provide scheduledAt to queue the message for future delivery instead of sending immediately. Returns: id, recipientCount, createdAt. Required: includedLists.
- **update_a_fanvue_chats_mass_message_by_id** — Update a scheduled fanvue mass message before it is sent. Only messages with SCHEDULED status can be modified. Returns an empty 204 response on success. Required: id.
- **delete_a_fanvue_chats_mass_message_by_id** — Delete/unsend a fanvue mass message by id. Messages already purchased by recipients remain available to them. Returns an empty 204 response on success. Required: id.
- **fanvue_chats_mass_messages_list_2** — List mass messages for a specific fanvue creator, with delivery and engagement statistics per message. Returns: data (array of mass messages with uuid, status, recipientCount, totalRevenue, mediaUuids, includedLists per item), pagination. Required: creator_user_uuid.
- **fanvue_chats_mass_messages_create_2** — Send a fanvue mass message on behalf of a specific creator to multiple users based on selected recipient lists. Provide scheduledAt to queue for future delivery. Returns: id, recipientCount, createdAt. Required: creator_user_uuid, includedLists.
- **fanvue_chats_mass_messages_update_2** — Update a scheduled mass message for a specific fanvue creator before it is sent. Only messages with SCHEDULED status can be modified. Returns an empty 204 response on success. Required: creator_user_uuid, message_uuid.
- **fanvue_chats_mass_messages_delete_2** — Delete/unsend a mass message for a specific fanvue creator. Messages already purchased by recipients remain available to them. Returns an empty 204 response on success. Required: creator_user_uuid, message_uuid.
- **list_all_fanvue_chats_unreads** — Get unread chats, messages, and notifications count in fanvue for the authenticated user. Returns: unreadChatsCount, unreadMessagesCount, and unreadNotifications (including newFollower, newPostComment, newPostLike, newPurchase, newSubscriber, newTip, and newPromotion counts).
- **fanvue_chats_unreads_list_2** — Get unread chats, messages, and notifications count in fanvue for a specific creator. Returns: unreadChatsCount, unreadMessagesCount, and unreadNotifications (including newFollower, newPostComment, newPostLike, newPurchase, newSubscriber, newTip, and newPromotion counts). Required: creator_user_uuid.
- **create_a_fanvue_chats_status** — Get online statuses for multiple fanvue users in a single batch request. Returns a map of user UUIDs to status objects, each containing isOnline and lastSeenAt. Required: userUuids. Maximum 100 UUIDs per request; users with disabled online visibility always appear offline with a null lastSeenAt.
- **fanvue_chats_statuses_create_2** — Get online statuses for multiple fanvue users from the perspective of a specific creator. Returns a map of user UUIDs to status objects, each containing isOnline and lastSeenAt. Required: creator_user_uuid, userUuids. Maximum 100 UUIDs per request.
- **create_a_fanvue_messages_batch** — Fetch the most recent fanvue messages for up to 50 chats in a single bulk request. Returns: byChat — a map of chat UUID to per-chat results where each entry contains messages (uuid, text, sentAt, sender, recipient, type, hasMedia, mediaType, mediaUuids, pricing, purchasedAt, sentByUserId, isRead), hasMore, and oldestMessageUuid on success, or an error key for unreachable chats. Required: chatUuids. Maximum 50 chat UUIDs per request.
- **fanvue_messages_batches_create_2** — Fetch the most recent fanvue messages for up to 50 chats in a single bulk request scoped to a specific creator. Returns: byChat — a map of chat UUID to per-chat results where each entry contains messages (uuid, text, sentAt, sender, recipient, type, hasMedia, mediaType, mediaUuids, pricing, purchasedAt, sentByUserId, isRead), hasMore, and oldestMessageUuid on success, or an error key for unreachable chats. Required: creator_user_uuid, chatUuids. Maximum 50 chat UUIDs per request.
- **list_all_fanvue_lists_smarts** — List all available fanvue smart lists with member counts. Returns: name, uuid, and count for each system-generated audience segment (e.g., subscribers, followers, auto_renewing).
- **fanvue_lists_smarts_list_2** — List members of a specific fanvue smart list by uuid. Returns: data (array of members with uuid, displayName, handle, isCreator) and pagination (page, size, hasMore). Required: uuid.
- **fanvue_lists_smarts_list_3** — List all fanvue smart lists for a specific creator with member counts. Returns: name, uuid, and count per system-generated audience segment. Required: creator_user_uuid.
- **fanvue_lists_smarts_list_4** — List members of a specific smart list for a fanvue creator. Returns: data (array of members with uuid, displayName, handle, isCreator) and pagination (page, size, hasMore). Required: creator_user_uuid, uuid.
- **list_all_fanvue_lists_customs** — List fanvue custom lists with member counts. Returns: uuid, name, membersCount, createdAt per list item. Supports optional name filtering via the search parameter.
- **create_a_fanvue_lists_custom** — Create a new fanvue custom list for organizing contacts. Returns: uuid, name, createdAt. Required: name.
- **fanvue_lists_customs_list_2** — List members of a specific fanvue custom list with pagination. Returns: uuid, displayName, handle, isCreator per member. Required: uuid.
- **update_a_fanvue_lists_custom_by_id** — Rename a fanvue custom list by uuid. Returns an empty 204 response on success. Required: uuid, name.
- **delete_a_fanvue_lists_custom_by_id** — Delete a fanvue custom list by uuid and remove all its members. Returns an empty 204 response on success. Required: uuid.
- **fanvue_lists_customs_attach_member** — Add one or more users to a fanvue custom list. Returns: added, skipped. Required: uuid, userUuids. Max 100 users per request; existing members are silently skipped.
- **fanvue_lists_customs_list_3** — List fanvue custom lists for a specific creator with member counts. Returns: uuid, name, membersCount, createdAt per list item. Required: creator_user_uuid.
- **fanvue_lists_customs_create_2** — Create a new fanvue custom list for a specific creator. Returns: uuid, name, createdAt. Required: creator_user_uuid, name.
- **fanvue_lists_customs_list_4** — List members of a specific fanvue creator's custom list with pagination. Returns: uuid, displayName, handle, isCreator per member. Required: creator_user_uuid, uuid.
- **fanvue_lists_customs_update_2** — Rename a fanvue custom list for a specific creator. Returns an empty 204 response on success. Required: creator_user_uuid, uuid, name.
- **fanvue_lists_customs_delete_2** — Delete a fanvue custom list for a specific creator and remove all its members. Returns an empty 204 response on success. Required: creator_user_uuid, uuid.
- **fanvue_lists_customs_attach_member_2** — Add one or more users to a specific fanvue creator's custom list. Returns: added, skipped. Required: creator_user_uuid, uuid, userUuids. Max 100 users per request; existing members are silently skipped.
- **delete_a_fanvue_member_by_id** — Remove a member from a fanvue custom chat list. Returns an empty 204 response on success. Required: uuid (custom list UUID), user_uuid (UUID of the user to remove).
- **fanvue_members_delete_2** — Remove a member from a specific fanvue creator's custom chat list. Returns an empty 204 response on success. Required: creator_user_uuid, uuid (custom list UUID), user_uuid (UUID of the user to remove).
- **list_all_fanvue_chats_templates** — List fanvue chat template messages, optionally filtered by folder name using case-insensitive partial matching. Returns: uuid, text, price, mediaUuids, folderName.
- **fanvue_chats_templates_list_2** — Get a single fanvue chat template message by UUID. Returns: uuid, text, price, mediaUuids, folderName. Required: template_uuid.
- **get_single_fanvue_chats_template_by_id** — Get a single fanvue chat template message by id. Returns: uuid, text, price, mediaUuids, folderName. Required: id.
- **list_all_fanvue_collections** — List fanvue content collections for the authenticated creator. Returns: uuid, label, createdAt.
- **create_a_fanvue_collection** — Create a new fanvue content collection for the authenticated creator. Returns: uuid, label, createdAt. Required: label.
- **update_a_fanvue_collection_by_id** — Rename an existing fanvue content collection by id. Returns an empty 204 response on success. Required: id, label.
- **delete_a_fanvue_collection_by_id** — Delete a fanvue content collection by id. Posts assigned to the collection remain; only the collection association is removed. Returns an empty 204 response on success. Required: id.
- **list_all_fanvue_creators** — List fanvue creators associated with the authenticated agency's organization. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt, and role. Max 50 creators per page.
- **list_all_fanvue_creator_followers** — List fanvue followers for a specified creator. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt. Required: creator_user_uuid.
- **list_all_fanvue_creator_accounts** — Get the fanvue account view for a creator managed by the authenticated agency team member. Returns: uuid, email, handle, displayName, isCreator, createdAt, updatedAt, avatarUrl, bannerUrl, bio, and account (containing status, earnings totals in USD cents, and fan counts). Required: creator_user_uuid.
- **list_all_fanvue_creator_subscribers** — List fanvue subscribers for a given creator. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt. Required: creator_user_uuid.
- **list_all_fanvue_creator_notifications** — List notifications received by a fanvue creator. Returns: uuid, createdAt, eventType, isRead, data, originator, and receiverUuid for each notification. Optionally filter by eventType (e.g. 11=tip, 12=new follower). Required: creator_user_uuid.
- **list_all_fanvue_creator_chats** — List fanvue chats for a creator. Returns: createdAt, lastMessageAt, isRead, isMuted, unreadMessagesCount, user, lastMessage. Required: creator_user_uuid.
- **create_a_fanvue_creator_chat** — Create a new fanvue chat conversation as a creator with a specified user. Returns: message. Required: creator_user_uuid, userUuid.
- **fanvue_creator_chats_list_messages** — List messages between a fanvue creator and a specified user, ordered newest first. Returns: uuid, text, sentAt, sender, recipient, type, hasMedia, mediaType, mediaUuids, pricing, purchasedAt, sentByUserId, isRead. Required: creator_user_uuid, user_uuid.
- **update_a_fanvue_creator_chat_by_id** — Update properties of a fanvue creator chat conversation, such as marking it as read, muting it, or setting a custom nickname for the user. Returns an empty 204 response on success. Required: creator_user_uuid, id.
- **list_all_fanvue_link_purchaseds** — Check if a fanvue creator has purchased a specific media link. Returns: purchased (boolean indicating whether the creator has a paid invoice for the media link). Required: creator_user_uuid, uuid.
- **fanvue_link_purchaseds_list_2** — Check if the authenticated fanvue user has purchased a specific media link. Returns: purchased (boolean indicating whether the authenticated user has a paid invoice for the media link). Required: uuid.
- **create_a_fanvue_grant** — Grant a consumer access to a specific creator's media item in fanvue. The operation is idempotent — repeated calls with the same parameters return the existing entitlement. Returns: entitlementId, status. Required: creator_user_uuid, uuid, consumerId, source, sourceRef.
- **fanvue_grants_create_2** — Grant a consumer access to a media item owned by the authenticated creator in fanvue. The operation is idempotent — repeated calls with the same parameters return the existing entitlement. Returns: entitlementId, status. Required: uuid, consumerId, source, sourceRef.
- **list_all_fanvue_entitleds** — Get a fanvue media item owned by a specific creator for a verified entitled consumer, returning signed variant URLs. Returns: uuid, status, mediaType, createdAt, caption, name, variants, purchasedByFan, tags. Required: creator_user_uuid, uuid, consumerId.
- **fanvue_entitleds_list_2** — Get a fanvue media item for a verified entitled consumer without scoping to a specific creator, returning signed variant URLs. Returns: uuid, status, mediaType, createdAt, caption, name, variants, purchasedByFan, tags. Required: uuid, consumerId.
- **list_all_fanvue_insights_earnings** — List fanvue creator earnings transactions with cursor pagination. Returns per-transaction: date, gross, net, currency, source, transactionOrderId, transactionOrderStatus, and user (fan info). Optionally filter by startDate, endDate, or source. Max 50 items per page.
- **fanvue_insights_earnings_list_2** — List fanvue creator earnings for the authenticated creator, returning the full response envelope. Returns: data (array of transactions with date, gross, net, currency, source, transactionOrderId, transactionOrderStatus, and user info) and nextCursor. Optionally filter by startDate, endDate, or source.
- **list_all_fanvue_earnings_summaries** — Get aggregated earnings summary for a specific fanvue creator by UUID. Returns: totals (all-time and this-month gross/net with month-over-month change percentages), breakdownBySource, earningsByType, overTime chart series, averageByDayOfWeek, averageByHourOfDay, and period. Required: creator_user_uuid.
- **fanvue_earnings_summaries_list_2** — Get aggregated earnings summary for the authenticated fanvue creator. Returns: totals (all-time and this-month gross/net with month-over-month change percentages), breakdownBySource, earningsByType, overTime chart series, averageByDayOfWeek, averageByHourOfDay, and period.
- **list_all_fanvue_earnings_percentiles** — Get the earnings percentile for a specific fanvue creator based on their gross earnings over the last 30 days. Returns: percentile. Required: creator_user_uuid.
- **fanvue_earnings_percentiles_list_2** — Get the earnings percentile for the authenticated fanvue creator based on their gross earnings over the last 30 days. Returns: percentile.
- **list_all_fanvue_insights_spendings** — List spending reversal data for a specific Fanvue creator. Returns cursor-paginated refund and chargeback transaction records including date, gross, net, currency, source, messageUuid, postUuid, and user. Required: creator_user_uuid.
- **fanvue_insights_spendings_list_2** — List spending reversal data for the authenticated Fanvue creator. Returns the full paginated envelope including a data array of refund and chargeback records (each with date, gross, net, currency, source, and user) and a nextCursor for subsequent pages.
- **list_all_fanvue_insights_subscribers** — List daily subscriber events over time for a fanvue creator, returning an analytics time series (not a real-time subscriber snapshot). Returns: date, total, newSubscribersCount, cancelledSubscribersCount per daily bucket. Required: creator_user_uuid.
- **fanvue_insights_subscribers_list_2** — List daily subscriber events over time for the authenticated fanvue creator, returning an analytics time series (not a real-time subscriber snapshot). Returns: data (array of daily buckets containing date, total, newSubscribersCount, cancelledSubscribersCount) and nextCursor.
- **list_all_fanvue_insights_top_spenders** — List top-spending fans for a specific Fanvue creator. Returns per-fan records including gross (total amount paid in USD cents), net (creator earnings after Fanvue fees), messages count, and user details (uuid, handle, displayName, isTopSpender, avatarUrl, registeredAt). Required: creator_user_uuid.
- **fanvue_insights_top_spenders_list_2** — List top-spending fans for the authenticated Fanvue creator. Returns: data (array of fan spending records containing gross, net, messages, and user details) and pagination metadata (page, size, hasMore). Supports optional startDate and endDate filters.
- **list_all_fanvue_insights_fans** — List fan insight records in fanvue. Returns individual records including status, spending (lastPurchaseAt, total, maxSinglePayment, sources), and subscription (createdAt, renewsAt, autoRenewalEnabled).
- **fanvue_insights_fans_list_2** — Get bulk fan insights for a specific creator in fanvue. Returns results (map of fan UUID to insights with status, spending, and subscription) and errors for unresolved entries. Required: creator_user_uuid, fanUuids. Max 20 fan UUIDs per request.
- **fanvue_insights_fans_list_3** — Get bulk fan insights for the authenticated fanvue creator. Returns results (map of fan UUID to insights with status, spending, and subscription) and errors for unresolved entries. Required: fanUuids. Max 20 fan UUIDs per request.
- **fanvue_insights_fans_list_4** — Get fan insights for a specific fanvue fan by their UUID for the authenticated creator. Returns status, spending (lastPurchaseAt, total, maxSinglePayment, sources), and subscription (createdAt, renewsAt, autoRenewalEnabled). Required: user_uuid.
- **get_single_fanvue_insights_fan_by_id** — Get fan insights for a specific fanvue fan by UUID. Returns status, spending (lastPurchaseAt, total, maxSinglePayment, sources), and subscription (createdAt, renewsAt, autoRenewalEnabled). Required: id.
- **create_a_fanvue_fans_batch** — Get fanvue fan insights in bulk for a specific creator. Returns a map of fan UUID to per-fan insights including status, spending, and subscription details, or a per-key error (forbidden, not_found, internal). Required: creator_user_uuid, userUuids. Max 100 fan UUIDs per request.
- **fanvue_fans_batches_create_2** — Get fanvue fan insights in bulk without scoping to a specific creator. Returns a map of fan UUID to per-fan insights including status, spending, and subscription details, or a per-key error (forbidden, not_found, internal). Required: userUuids. Max 100 fan UUIDs per request.
- **create_a_fanvue_media_upload** — Create a fanvue media record and start an S3 multipart upload session. Returns: mediaUuid, uploadId. Required: name, filename, mediaType.
- **fanvue_media_uploads_bulk_update** — Complete a creator's S3 multipart upload session in fanvue, setting the media status to processing. Media URLs become available once processing finishes. Returns: status. Required: creator_user_uuid, upload_id.
- **fanvue_media_uploads_create_2** — Create a fanvue media record and start an S3 multipart upload session. Returns: mediaUuid, uploadId. Required: name, filename, mediaType.
- **update_a_fanvue_media_upload_by_id** — Complete a fanvue S3 multipart upload session by upload ID, setting the media status to processing. Media URLs become available once processing finishes. Returns: status. Required: id.
- **list_all_fanvue_part_urls** — Get a presigned S3 URL for uploading a specific part of a creator's multipart media upload session in fanvue. Returns a presigned URI string to use when uploading that part. Required: creator_user_uuid, upload_id.
- **fanvue_part_urls_list_2** — Get a presigned S3 URL for uploading a specific part of a media upload session in fanvue. Returns a presigned URI string to use when uploading that part. Required: upload_id.
- **list_all_fanvue_creator_posts** — List fanvue posts for a creator ordered by pinned status first, then newest first. Returns: uuid, createdAt, text, price, audience, publishedAt, isPinned, likesCount, commentsCount, tips, collections. Required: creator_user_uuid.
- **create_a_fanvue_creator_post** — Create a new fanvue post on behalf of a creator with optional media, text, and pricing. Returns: uuid, createdAt, text, price, audience, publishAt, publishedAt, expiresAt, mediaPreviewUuid. Required: creator_user_uuid, audience.
- **fanvue_creator_posts_list_2** — Get a specific fanvue post by UUID for a creator. Returns: uuid, createdAt, text, price, audience, publishedAt, mediaUuids, isPinned, likesCount, commentsCount, tips, collections. Required: creator_user_uuid, uuid.
- **update_a_fanvue_creator_post_by_id** — Update an existing fanvue post for a creator; only provided fields are modified. Setting publishAt to null on a scheduled post publishes it immediately. Returns: uuid, createdAt, text, price, audience, publishedAt, mediaUuids, isPinned, likesCount, commentsCount, tips, collections. Required: creator_user_uuid, id.
- **delete_a_fanvue_creator_post_by_id** — Soft-delete a fanvue post by id on behalf of a creator. Returns an empty 204 response on success. Required: creator_user_uuid, id.
- **fanvue_creator_posts_list_comments** — List comments on a specific fanvue post owned by a creator. Returns: uuid, text, user, createdAt, updatedAt. Required: creator_user_uuid, uuid.
- **fanvue_creator_posts_attach_comment** — Add a comment to a fanvue post on behalf of a creator. Returns: uuid, text, user, createdAt, updatedAt. Required: creator_user_uuid, uuid.
- **get_single_fanvue_creator_post_by_id** — Get a single fanvue post by id for a creator. Returns: uuid, createdAt, text, price, audience, publishedAt, mediaUuids, isPinned, likesCount, commentsCount, tips, collections. Required: creator_user_uuid, id.
- **list_all_fanvue_post_tips** — List tips received on a specific fanvue post. Returns each tip record including user (uuid, handle, displayName, avatarUrl, isTopSpender, registeredAt), createdAt (date/time the tip was paid), gross, and net amounts in cents. Required: uuid.
- **fanvue_post_tips_list_2** — List tips received on a specific fanvue post, returning the full paginated envelope. Returns: data (array of tip records each containing user, createdAt, gross, net) and pagination (page, size, hasMore). Required: uuid.
- **list_all_fanvue_post_likes** — List fanvue likes on a specific post. Returns: user (uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt), createdAt. Required: uuid.
- **fanvue_post_likes_list_2** — List fanvue likes on a specific post, returning the full paginated envelope. Returns: data (array of like objects each containing user and createdAt), pagination (page, size, hasMore). Required: uuid.
- **create_a_fanvue_post_repost** — Repost a fanvue post on behalf of a creator, re-surfacing it by updating its publication date to now and moving it to the top of the feed. Returns: uuid, createdAt, publishedAt, text, audience, mediaUuids, isPinned, likesCount, commentsCount, tips, collections. Required: uuid.
- **fanvue_post_reposts_create_2** — Repost a fanvue post, re-surfacing it by updating its publication date to now and moving it to the top of the feed. Only the post owner can repost their own content. Returns: uuid, createdAt, publishedAt, text, audience, mediaUuids, isPinned, likesCount, commentsCount, tips, collections. Required: uuid.
- **create_a_fanvue_post_pin** — Pin a fanvue post on behalf of a creator so it appears at the top of the feed. Returns: uuid, isPinned, createdAt, text, audience, mediaUuids, likesCount, commentsCount, tips, collections. Required: uuid.
- **delete_a_fanvue_post_pin_by_id** — Unpin a fanvue post on behalf of a creator so it returns to normal feed ordering. Returns: uuid, isPinned, createdAt, text, audience, mediaUuids, likesCount, commentsCount, tips, collections. Required: uuid.
- **fanvue_post_pins_create_2** — Pin a fanvue post so it appears at the top of the feed; only the post owner can pin their own content. Returns: uuid, isPinned, createdAt, text, audience, mediaUuids, likesCount, commentsCount, tips, collections. Required: uuid.
- **fanvue_post_pins_delete_2** — Unpin a fanvue post so it returns to normal feed ordering; only the post owner can unpin their own content. Returns: uuid, isPinned, createdAt, text, audience, mediaUuids, likesCount, commentsCount, tips, collections. Required: uuid.
- **delete_a_fanvue_post_comment_by_id** — Delete a comment from a fanvue post on behalf of a creator. The comment may be removed by either the comment author or the post owner. Returns an empty 204 response on success. Required: uuid, id.
- **fanvue_post_comments_delete_2** — Delete a comment from a fanvue post. The comment may be removed by either the comment author or the post owner. Returns an empty 204 response on success. Required: uuid, comment_uuid.
- **list_all_fanvue_creator_tracking_links** — List tracking links for a fanvue creator, with optional date-range filters. Returns: uuid, name, linkUrl, externalSocialPlatform, createdAt, clicks, engagement (acquiredSubscribers, acquiredFollowers, totalSubscribers, totalFollowers), and earnings (totalGross, totalNet). Required: creator_user_uuid.
- **create_a_fanvue_creator_tracking_link** — Create a new tracking link for a fanvue creator. Returns: uuid, name, linkUrl, externalSocialPlatform, createdAt, clicks, engagement, and earnings (null on initial creation). Required: creator_user_uuid, name, externalSocialPlatform.
- **delete_a_fanvue_creator_tracking_link_by_id** — Delete a tracking link for a fanvue creator by id. Returns an empty 204 response on success. Required: creator_user_uuid, id.
- **list_all_fanvue_tracking_link_users** — List fanvue users associated with a tracking link, returning individual user records extracted from the paginated response. Returns each user's uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt, subscribedAt, followedAt, clickedAt, and status. Required: uuid.
- **fanvue_tracking_link_users_list_2** — List fanvue users associated with a tracking link owned by the authenticated user, returning the full paginated response envelope. Returns: data (array of user objects each containing uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt, subscribedAt, followedAt, clickedAt, and status), and nextCursor for pagination. Required: uuid.
- **list_all_fanvue_metadata** — Get custom tracking metadata for a user on a fanvue creator's tracking link, drawn from the user's most recent impression on that link. Returns: metadata (an object of arbitrary key-value string pairs, e.g. lead_id, source, conversation_id). Required: creator_user_uuid, uuid, user_uuid.
- **fanvue_metadata_list_2** — Get custom tracking metadata for a fanvue user from their most recent impression on a tracking link. Returns: metadata (an object of arbitrary key-value string pairs, e.g. lead_id, source, conversation_id). Required: uuid, user_uuid.
- **list_all_fanvue_subscribers_onlines** — List currently online subscribers for a fanvue creator. Returns: data (array of subscriber objects each containing uuid and lastSeenAt), count. Required: creator_user_uuid. Optionally filter to specific subscribers via subscriberUuids.
- **list_all_fanvue_vault_folders** — List fanvue vault folders for the authenticated user. Returns individual folder records extracted from the paginated envelope. Returns: name, createdAt, mediaCount.
- **create_a_fanvue_vault_folder** — Create a new folder in the authenticated fanvue user's vault. Returns: name, createdAt, mediaCount. Required: name.
- **fanvue_vault_folders_list_2** — Get details of a specific fanvue creator vault folder by name. Returns: name, createdAt, mediaCount. Required: creator_user_uuid, folder_name.
- **update_a_fanvue_vault_folder_by_id** — Rename a fanvue vault folder by id. Returns an empty 204 response on success. Required: id, name.
- **delete_a_fanvue_vault_folder_by_id** — Delete a fanvue vault folder by id. Media items in the folder are detached but not deleted. Returns an empty 204 response on success. Required: id.
- **fanvue_vault_folders_list_3** — List fanvue vault folders for the authenticated user, returning the full paginated envelope. Returns: data (array of folders with name, createdAt, mediaCount) and pagination (page, size, hasMore).
- **fanvue_vault_folders_create_2** — Create a new folder in the authenticated fanvue user's vault. Returns: name, createdAt, mediaCount. Required: name.
- **fanvue_vault_folders_list_4** — Get details of a specific fanvue vault folder by name for the authenticated user. Returns: name, createdAt, mediaCount. Required: folder_name.
- **fanvue_vault_folders_update_2** — Rename a fanvue vault folder identified by its current name. Returns an empty 204 response on success. Required: folder_name, name.
- **fanvue_vault_folders_delete_2** — Delete a fanvue vault folder by name. Media items in the folder are detached but not deleted. Returns an empty 204 response on success. Required: folder_name.
- **get_single_fanvue_vault_folder_by_id** — Get a single fanvue vault folder by id. Returns: name, createdAt, mediaCount. Required: id.
- **list_all_fanvue_followers** — List fanvue users who follow the authenticated user, excluding those with active subscriptions to avoid duplication. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt, role.
- **list_all_fanvue_notifications** — List fanvue notifications for the authenticated user, ordered by most recent first. Returns: uuid, createdAt, eventType, isRead, data, originator, and receiverUuid. Optionally filter by event type using eventType.
- **list_all_fanvue_subscribers** — List fanvue subscribers — users who have active subscriptions to the authenticated creator. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt, role. Optionally sort results by sortField (name or subscribedAt) and sortDirection (asc or desc).
- **list_all_fanvue_tracking_links** — List fanvue tracking links for the authenticated user. Returns: uuid, name, linkUrl, externalSocialPlatform, createdAt, clicks, engagement (acquiredSubscribers, acquiredFollowers, totalSubscribers, totalFollowers), and earnings (totalGross, totalNet). Supports optional date range filtering via createdAfter and createdBefore.
- **create_a_fanvue_tracking_link** — Create a new tracking link in fanvue for the authenticated user. Returns: uuid, name, linkUrl, externalSocialPlatform, createdAt, clicks, engagement, and earnings (null on creation). Required: name, externalSocialPlatform.
- **delete_a_fanvue_tracking_link_by_id** — Delete a fanvue tracking link by id. Returns an empty 204 response on success. Required: id.
- **list_all_fanvue_users** — Get details of the currently authenticated fanvue user. Returns: uuid, email, handle, displayName, bio, isCreator, createdAt, updatedAt, avatarUrl, bannerUrl, likesCount, fanCounts (followersCount, subscribersCount), and contentCounts (imageCount, videoCount, audioCount, postCount, payToViewPostCount).
- **list_all_fanvue_users_accounts** — Get the authenticated fanvue user's account view, including profile and monetisation data. Returns: uuid, email, handle, displayName, isCreator, createdAt, updatedAt, avatarUrl, bannerUrl, bio, and a nested account object containing status, earnings totals (total, availableBalance, lastPayoutAt), and fan counts (followers, subscribers). No required parameters.
- **list_all_fanvue_webhooks_subscriptions** — List the authenticated creator's active webhook subscriptions in fanvue. Returns: id, url, events, createdAt.
- **create_a_fanvue_webhooks_subscription** — Create a webhook subscription in fanvue to deliver one or more platform events to a public HTTPS URL. Returns: id, signingSecret (returned only at creation time — store it securely). Required: url, events.
- **delete_a_fanvue_webhooks_subscription_by_id** — Delete a fanvue webhook subscription by id. Returns an empty 204 response on success. Required: id.
- **list_all_fanvue_chats_smart_lists** — List all available fanvue smart lists with member counts. Smart lists are system-generated dynamic audience segments (e.g., subscribers, followers, auto_renewing, expired_subscribers) computed from subscription and relationship state. Returns: uuid, name, count.
- **get_single_fanvue_chats_smart_list_by_id** — Get members of a specific fanvue smart list by its uuid. Members are filtered by contactability and the selected smart list type. Returns: uuid. Required: id.
- **list_all_fanvue_chats_custom_lists** — List fanvue custom chat lists for the authenticated user, including member counts. Supports optional name-based search. Returns: uuid, name, memberCount.
- **create_a_fanvue_chats_custom_list** — Create a new custom chat list in fanvue. Returns: uuid, name, memberCount. Required: name.
- **get_single_fanvue_chats_custom_list_by_id** — Get a single fanvue custom chat list by id. Returns: uuid, name, memberCount. Required: id.
- **update_a_fanvue_chats_custom_list_by_id** — Update a fanvue custom chat list by id. Returns: uuid, name, memberCount. Required: id.
- **delete_a_fanvue_chats_custom_list_by_id** — Delete a fanvue custom chat list by id. Returns an empty 204 response on success. Required: id.
- **fanvue_chats_custom_lists_attach_member** — Add a member to a fanvue custom chat list identified by uuid. Returns an empty 204 response on success. Required: uuid.
- **fanvue_chats_custom_lists_detach_member** — Remove a member from a fanvue custom chat list. Returns an empty 204 response on success. Required: uuid, id.
- **list_all_fanvue_chat_message_media** — Resolve media attachments for a fanvue chat message, returning signed variant URLs and metadata for each requested media UUID. Returns: mediaUuid, variants, error. Required: user_uuid, message_uuid, mediaUuids. Accepts up to 20 comma-separated UUIDs per request.
- **list_all_fanvue_creator_online_subscribers** — List fanvue subscribers who are currently online for a given creator. Returns: uuid. Required: creator_user_uuid. Optionally filters results to specific subscribers when subscriberUuids is provided.
- **create_a_fanvue_creator_chat_message** — Send a message in a fanvue chat on behalf of a creator to a specific user. Returns: id. Required: creator_user_uuid, user_uuid.
- **delete_a_fanvue_creator_chat_message_by_id** — Delete a specific message from a fanvue chat between a creator and a user by message id. Returns an empty 204 response on success. Required: creator_user_uuid, user_uuid, id.
- **list_all_fanvue_creator_chats_mass_messages** — List fanvue mass messages for a creator. Returns: id, recipientCount, createdAt. Required: creator_user_uuid.
- **create_a_fanvue_creator_chats_mass_message** — Create and send a fanvue mass message to one or more recipient lists for a creator. Returns: id, recipientCount, createdAt. Required: creator_user_uuid, includedLists. Must provide text or mediaUuids (or both); price requires mediaUuids and must be at least 200 cents ($2.00).
- **update_a_fanvue_creator_chats_mass_message_by_id** — Update a fanvue mass message for a creator by id. Returns: id, recipientCount, createdAt. Required: creator_user_uuid, id.
- **delete_a_fanvue_creator_chats_mass_message_by_id** — Delete and unsend a fanvue mass message for a creator by id. Returns an empty 204 response on success. Required: creator_user_uuid, id.
- **list_all_fanvue_creator_chats_unreads** — List unread chats for a fanvue creator. Returns: uuid. Required: creator_user_uuid.
- **create_a_fanvue_creator_chats_status** — Create (batch-update) online chat statuses for a fanvue creator. Submits a batch online-status update scoped to the specified creator. Required: creator_user_uuid. Returns an empty 204 response on success.
- **create_a_fanvue_creator_messages_batch** — Send a batch of chat messages on behalf of a fanvue creator. Returns an empty 204 response on success. Required: creator_user_uuid.
- **list_all_fanvue_creator_chats_smart_lists** — List all available fanvue smart lists for a creator, returning system-generated dynamic audience segments with member counts (e.g. subscribers, followers, auto_renewing, expired_subscribers). Returns: uuid, name, count. Required: creator_user_uuid.
- **get_single_fanvue_creator_chats_smart_list_by_id** — Get members of a specific fanvue creator smart list by smart list id, returning paginated fan member records filtered by contactability and list type. Returns: uuid, username, display_name. Required: creator_user_uuid, id.
- **list_all_fanvue_creator_chats_custom_lists** — List all custom chat lists for a fanvue creator, including the member count for each list. Returns: uuid, memberCount. Required: creator_user_uuid.
- **create_a_fanvue_creator_chats_custom_list** — Create a new custom chat list for a fanvue creator. Returns: uuid, memberCount. Required: creator_user_uuid.
- **get_single_fanvue_creator_chats_custom_list_by_id** — Get a single custom chat list by id for a fanvue creator. Returns: uuid, memberCount. Required: creator_user_uuid, id.
- **update_a_fanvue_creator_chats_custom_list_by_id** — Update a custom chat list by id for a fanvue creator. Returns: uuid, memberCount. Required: creator_user_uuid, id.
- **delete_a_fanvue_creator_chats_custom_list_by_id** — Delete a custom chat list by id for a fanvue creator. Returns an empty 204 response on success. Required: creator_user_uuid, id.
- **fanvue_creator_chats_custom_lists_attach_member** — Add a member to a fanvue creator's custom chat list. Returns an empty 204 response on success. Required: creator_user_uuid, uuid.
- **fanvue_creator_chats_custom_lists_detach_member** — Remove a member from a fanvue creator's custom chat list by member id. Returns an empty 204 response on success. Required: creator_user_uuid, uuid, id.
- **list_all_fanvue_creator_chat_media** — List media attachments for a fanvue creator chat conversation. Returns: mediaUuid, messageUuid, and variants containing signed URLs (e.g., thumbnail, main) per media item. URLs are short-lived — resolve them fresh when displaying to users. Required: creator_user_uuid, user_uuid.
- **list_all_fanvue_creator_chat_message_media** — List resolved media attachments for a fanvue creator chat message, returning metadata and signed variant URLs for each requested media item. Returns: mediaUuid, variants. Required: creator_user_uuid, user_uuid, message_uuid, mediaUuids. Accepts up to 20 comma-separated media UUIDs per request; resolve lazily as media scrolls into view and re-resolve on 403.
- **list_all_fanvue_creator_media** — List fanvue creator media items in a paginated response. Returns: uuid, status, variants (variants included only for FINALISED media; non-FINALISED items return only uuid and status). Required: creator_user_uuid.
- **get_single_fanvue_creator_media_by_id** — Get a single fanvue creator media item by id. Returns: uuid, status, variants (variants included only when status is FINALISED; non-FINALISED items return only uuid and status). Required: creator_user_uuid, id.
- **fanvue_creator_media_bulk_list** — Bulk-retrieve fanvue creator media items in a single response. Returns: uuid, status, variants (variants included only for FINALISED media; non-FINALISED items return only uuid and status). Required: creator_user_uuid.
- **list_all_fanvue_vault_media** — List media items in a fanvue vault folder. Returns lightweight items (without resolved variant URLs) for the specified folder. Returns: mediaUuid, status. Required: folder_name.
- **create_a_fanvue_vault_media** — Add a media item to a fanvue vault folder. Returns: mediaUuid, status. Required: folder_name.
- **delete_a_fanvue_vault_media_by_id** — Remove a media item from a fanvue vault folder by id. Only the folder association is removed — the media item itself is not deleted. Returns an empty 204 response on success. Required: folder_name, id.
- **list_all_fanvue_creator_vault_media** — List media items in a fanvue creator vault folder. Returns: uuid. Required: creator_user_uuid, folder_name.
- **create_a_fanvue_creator_vault_media** — Add media to a fanvue creator vault folder. Returns: uuid. Required: creator_user_uuid, folder_name.
- **delete_a_fanvue_creator_vault_media_by_id** — Remove a media item from a fanvue creator vault folder by id. The media item itself is not deleted — only the folder association is removed. Returns an empty 204 response on success. Required: creator_user_uuid, folder_name, id.
- **list_all_fanvue_media_link_purchases** — List purchase records for a fanvue media link. Returns purchase records identified by uuid for the specified media link. Required: uuid.
- **list_all_fanvue_creator_media_link_purchases** — List fanvue users who have purchased a specific creator's media link. Returns: uuid, user_uuid, created_at for each purchase record. Required: creator_user_uuid, uuid.
- **create_a_fanvue_media_grant** — Grant access to a fanvue media item by its UUID. Returns an empty 204 response on success. Required: uuid.
- **create_a_fanvue_creator_media_grant** — Grant access to a specific fanvue media item on behalf of a creator. Returns an empty 204 response on success. Required: creator_user_uuid, uuid.
- **list_all_fanvue_media_entitled** — Get a fanvue media item with signed variant URLs for a consumer who has been granted access via a prior entitlement grant. Returns: uuid, tags, and variant signed URLs. Required: uuid. Specify the `variants` query parameter (e.g., `main,thumbnail`) to include signed media URLs in the response; tags contains structured AI content metadata when enabled, or null if not yet processed.
- **list_all_fanvue_creator_media_entitled** — List fanvue users entitled to access a specific creator's media item. Returns a collection of entitlement records for the given media, each identified by its uuid. Required: creator_user_uuid, uuid.
- **create_a_fanvue_creator_media_upload** — Initiate a media upload session for a fanvue creator to begin a multipart S3 upload. Returns: id, status. Required: creator_user_uuid.
- **update_a_fanvue_creator_media_upload_by_id** — Complete a fanvue creator's multipart upload session in S3, setting the media status to processing. Media URLs become available once processing finishes. Returns: id, status. Required: creator_user_uuid, id.
- **list_all_fanvue_media_upload_part_urls** — Get a presigned URL for uploading a specific part of a fanvue multipart media upload session. Returns: url. Required: upload_id, part_number.
- **list_all_fanvue_creator_media_upload_part_urls** — Get a presigned URL for uploading a specific part of a creator's multipart media upload session in fanvue. Returns: url. Required: creator_user_uuid, upload_id, part_number.
- **list_all_fanvue_creator_vault_folders** — List folders in a fanvue creator's vault. Returns: name. Required: creator_user_uuid.
- **create_a_fanvue_creator_vault_folder** — Create a new folder in a fanvue creator's vault. Returns: name. Required: creator_user_uuid, name.
- **get_single_fanvue_creator_vault_folder_by_id** — Get a specific folder from a fanvue creator's vault by id (folder name). Returns: name. Required: creator_user_uuid, id.
- **update_a_fanvue_creator_vault_folder_by_id** — Rename an existing folder in a fanvue creator's vault. Returns: name. Required: creator_user_uuid, id, name.
- **delete_a_fanvue_creator_vault_folder_by_id** — Delete a folder from a fanvue creator's vault by id (folder name). Returns an empty 204 response on success. Required: creator_user_uuid, id.
- **list_all_fanvue_creator_post_tips** — List tips received on a specific fanvue creator's post. Returns: id. Required: creator_user_uuid, uuid.
- **list_all_fanvue_creator_post_likes** — List likes received on a specific fanvue creator's post. Returns a paginated list of like records including uuid, user, and created_at. Required: creator_user_uuid, uuid.
- **create_a_fanvue_creator_post_repost** — Create a repost of an existing fanvue post on behalf of a creator. Returns an empty 204 response on success. Required: creator_user_uuid, uuid.
- **create_a_fanvue_creator_post_pin** — Pin a fanvue creator's post to the top of their profile. Returns an empty 204 response on success. Required: creator_user_uuid, uuid.
- **delete_a_fanvue_creator_post_pin_by_id** — Unpin a fanvue creator's post, removing its pinned status from their profile. Returns an empty 204 response on success. Required: creator_user_uuid, uuid.
- **delete_a_fanvue_creator_post_comment_by_id** — Delete a comment on a fanvue creator's post by id. Returns an empty 204 response on success. Required: creator_user_uuid, uuid, id.
- **list_all_fanvue_creator_insights_earnings** — List fanvue creator earnings as cursor-paginated invoice transaction records over a specified time period. Returns transaction records each including fan payment details. Required: creator_user_uuid.
- **list_all_fanvue_insights_earnings_summaries** — Get pre-aggregated earnings metrics for the authenticated fanvue creator. Returns: all_time_totals, month_over_month, breakdowns, chart_series, and averages, covering all-time totals, month-over-month comparisons, source and type breakdowns, chart series data, and averages.
- **list_all_fanvue_creator_insights_earnings_summaries** — Get pre-aggregated earnings summary metrics for a fanvue creator. Returns all_time_totals, month_over_month comparisons, breakdowns by source and type, chart_series, and averages. Required: creator_user_uuid.
- **list_all_fanvue_insights_earnings_percentiles** — List earnings percentile data for the authenticated fanvue creator, showing where the creator's earnings rank relative to others on the platform. Returns: percentile.
- **list_all_fanvue_creator_insights_earnings_percentiles** — List earnings percentile insights for a fanvue creator. Returns: percentile. Required: creator_user_uuid.
- **list_all_fanvue_creator_insights_spendings** — List spending insights for a fanvue creator with cursor-based pagination. Returns spending insight records for the specified creator; the per-record field structure is not enumerated in the available source documentation. Required: creator_user_uuid.
- **list_all_fanvue_creator_insights_subscribers** — List subscriber insights for a fanvue creator, returning a paginated collection of subscriber records for the specified creator. Returns: userUuid, subscribedAt. Required: creator_user_uuid.
- **list_all_fanvue_creator_insights_top_spenders** — List the top-spending fans for a fanvue creator. Returns a paginated list of fans with their uuid, total_spent, and message_count. Required: creator_user_uuid.
- **list_all_fanvue_creator_insights_fans** — List fan insights for a fanvue creator. Returns a paginated list of fan records including user_uuid, total_spend, message_count, and subscription_status. Required: creator_user_uuid.
- **get_single_fanvue_creator_insights_fan_by_id** — Get detailed fan insights for a specific fan of a fanvue creator, including spending statistics, subscription status, and engagement metrics. Returns: user_uuid, total_spend, message_count, subscription_status. Required: creator_user_uuid, id.
- **create_a_fanvue_insights_fans_batch** — Retrieve fanvue fan insights for multiple fans in a single batch call. Returns: userUuid, spendingStatistics, subscriptionStatus, engagementMetrics for each requested fan.
- **create_a_fanvue_creator_insights_fans_batch** — Create a batch request to retrieve fan insights for a specific fanvue creator. Returns fan insight records including user_uuid, subscription_status, total_spent, and message_count for the requested fans. Required: creator_user_uuid.
- **list_all_fanvue_creator_tracking_link_users** — List users associated with a specific fanvue creator's tracking link, including per-user tracking metadata, using cursor-based pagination. Returns user records linked to the given tracking link. Returns: uuid. Required: creator_user_uuid, uuid.
- **list_all_fanvue_tracking_link_user_metadata** — Get the custom tracking metadata from a fanvue user's most recent impression on a tracking link. Returns custom metadata attributes whose field names and values are user-defined and vary per tracking link configuration. Required: uuid, user_uuid.
- **list_all_fanvue_creator_tracking_link_user_metadata** — Get custom tracking metadata for a specific user on a fanvue creator's tracking link, reflecting their most recent impression. Returns an attributes object containing custom metadata fields defined by the tracking link configuration in fanvue. Required: creator_user_uuid, uuid, user_uuid.

## How it works

1. **Link your customer's Fanvue account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app.
2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request.
3. **Call Truto's API to reach Fanvue.** The Proxy API is a 1-to-1 mapping of the Fanvue API.
4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field.

## Use cases

- **Power AI chat copilots for creator agencies** — Offer your messaging or AI agent product as a native Fanvue companion that reads incoming DMs, enriches them with fan spending history, and sends priced PPV replies. This unlocks the highest-revenue surface on Fanvue without your team handling OAuth flows or media upload quirks.
- **Build an agency command center for OFM businesses** — SaaS platforms managing portfolios of creators can offer centralized dashboards covering earnings, subscribers, and chatter leaderboards across every account. Truto handles the multi-tenant auth so agencies onboard new creators in seconds instead of sharing passwords.
- **Attribution and ROAS analytics for paid acquisition** — Marketing tools can provision Fanvue tracking links, resolve clicks to real Fanvue users, and follow their lifetime spend to prove ROI on TikTok, Reddit, and X ad spend. This turns your product into the source of truth for creator paid media.
- **Omnichannel content scheduling with vault sync** — Content scheduling and asset management SaaS can push large videos directly into the creator's Fanvue Vault via multipart uploads, then schedule posts and mass messages alongside other platforms. Truto abstracts the S3 part URL signing and chunking flow.
- **Financial reporting and chatter payroll automation** — BI and bookkeeping tools can pull daily earnings, spendings (refunds/chargebacks), and per-chatter performance metrics to auto-generate commission invoices. This replaces brittle CSV exports with reliable, agency-wide data feeds.

## What you can build

- **Unified PPV inbox with batch message sync** — Pull the latest messages across up to 50 chats per request to render a real-time multi-creator inbox with unread counts and read receipts.
- **Fan CRM with spend-based segmentation** — Hydrate fan profiles with total spend, max single payment, and last purchase date in bulk to drive lists, segments, and AI pricing decisions.
- **Mass message and PPV campaign scheduler** — Create, update, and delete mass messages with vault media attachments and price tags, scoped to smart lists or custom lists of subscribers.
- **Chatter performance and payroll dashboard** — Surface per-chatter revenue, PPVs sent, and unlock ratios from the chatter leaderboard endpoints to calculate commissions automatically.
- **Vault content manager with multipart uploads** — Let creators organize folders, upload 4K video files via signed part URLs, and reuse vault media across posts, DMs, and mass messages.
- **Tracking link attribution with LTV reporting** — Provision creator tracking links, resolve link-user metadata back to specific Fanvue UUIDs, and chart subscription LTV per acquisition source.
- **Webhook-driven automation triggers** — Subscribe to Fanvue events to fire automations on new messages, subscriptions, and tips without polling — ideal for AI agents and notification tools.

## FAQs

### How do end users authenticate their Fanvue accounts?

Fanvue uses OAuth 2.0, so your users connect through a hosted consent flow rather than pasting API keys or sharing passwords. Truto manages the token exchange, refresh, and per-tenant credential storage.

### Can a single connection access multiple creators in an agency?

Yes. Fanvue exposes agency-scoped endpoints (team members, agency chats, agency earnings, agency subscribers) that let one authenticated agency connection read and act across every creator in the portfolio.

### Does Truto support real-time events from Fanvue?

Yes. You can create and delete Fanvue webhook subscriptions through Truto, so your product reacts to new messages, tips, and subscriptions without polling list endpoints.

### How are large video uploads handled?

Fanvue uses an S3-style multipart upload flow. Truto exposes the create-upload, part URL, and bulk update tools so you can chunk multi-gigabyte files into the creator's Vault without managing presigning yourself.

### Can we send priced PPV messages and unlock private media?

Yes. You can create chat messages with media attachments and price tags, and resolve short-lived signed URLs for chat message media so your inbox UI can render previews securely.

### What insights data is available for building a fan CRM?

Truto supports earnings, earnings summaries and percentiles, spendings, subscribers, top spenders, and per-fan insights — including batch endpoints that hydrate analytics for many fans in a single call.

### Are creator-scoped and agency-scoped endpoints both supported?

Yes. Truto exposes both the creator-scoped tools (for individual creator OAuth connections) and the agency-scoped variants, so the same integration code works whether the connected account is a solo creator or an agency.