Fanvue
API integration

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.