# Fanvue MCP connector

The Fanvue connector brings your creators, subscribers, chats, mass messages, earnings and agency team into Claude, ChatGPT, Cursor and the Elaichi Agent, so each person works with Fanvue under their own sign-in.

Source: https://elaichi.ai/connectors/fanvue/

## Facts

| | |
| --- | --- |
| Application | Fanvue |
| Category | Subscription Platform |
| AI tools | 225 |
| Authentication | Connects over OAuth |
| Needs your own OAuth app | Yes |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. 225 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` |

## What you can ask once Fanvue is connected

- Summarize this week's Fanvue earnings by creator.
- Which chatters top the Fanvue leaderboard this month?
- How many subscribers did we gain in 14 days?

## Connect Fanvue in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick Fanvue.
2. Optionally set Share with, then press Connect.
3. Supply your own Fanvue app, then approve. Fanvue needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Fanvue tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## Connect Fanvue to Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## Connect Fanvue to ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web today. The plugin directory lives at chatgpt.com/plugins.

## Connect Fanvue to Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## Connect Fanvue to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Only Read is granted by default, which is not enough to call a Fanvue tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone.

## What teams do with Fanvue through Elaichi

### Onboard a new creator or team member

Agency operations. Send a Fanvue creator invite or team member invite from the same place the rest of the agency's work happens, then update a team member's details when their role changes.

### Reply to fans without leaving your workflow

Chat team. Open a subscriber's Fanvue chat, read the recent messages and send a reply, or start a new conversation with a fan who just subscribed.

### Schedule and tidy up mass messages

Marketing. Draft a mass message to a creator's Fanvue subscribers, fix a typo in one that is already set up, and remove a campaign that no longer applies.

### Pull agency earnings for the month

Finance. Ask for Fanvue earnings across the agency's creators for a period and get the figures ready to reconcile against payouts.

### Track how subscriber counts are moving

Growth. Look at Fanvue subscriber and follower history for a creator to see whether a promotion actually moved the numbers week over week.

### See which chatters are performing

Chat management. Check the Fanvue chatter leaderboard and the list of agency chats to see who is converting conversations and where fans are waiting on a reply.

## Frequently asked questions

### How do I connect Fanvue to Claude?

First, connect Fanvue in Elaichi. Fanvue asks you to register an OAuth application inside your Fanvue account, so someone brings a client ID and secret once, and after that each person simply signs in to Fanvue as themselves. Then open Claude, go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint. Fanvue is ready to use in Claude from that point.

### Does Fanvue work with ChatGPT and Cursor as well as Claude?

Yes. Once Fanvue is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Fanvue once and every client picks it up.

### What can an AI agent actually do with my Fanvue data?

An agent can read and reply to Fanvue chats, start a new chat with a subscriber, create, edit or remove mass messages, and pull up subscribers, earnings, follower history and chatter leaderboards for the agency. It can also invite creators and team members and update a team member's details. Short, concrete asks like "show this creator's earnings for March" work better than long paragraphs, because Fanvue exposes a lot of actions and the agent searches for the right one.

### Does connecting Fanvue give the AI access to every creator in my agency?

No. Access in Fanvue follows the person who signed in, so an agent working on someone's behalf sees only the creators, chats and earnings that person can already see in Fanvue. Elaichi can narrow that further, for example to reading only, but it can never widen it beyond what Fanvue itself allows that person.

### Can my team share one Fanvue connection?

Yes. One person connects Fanvue in Elaichi and shares the connection with a team, and nobody else ever handles the client ID, secret or any other credential. Each teammate still signs in to Elaichi as themselves, so the audit log records who sent which Fanvue message or pulled which earnings report.

### Can I stop an agent from deleting or changing things in Fanvue?

Yes. Restrictions in Elaichi work per action, so you can allow reading Fanvue chats and earnings while blocking the sending of mass messages or the deletion of chat messages. A blocked action is never shown to Claude, ChatGPT, Cursor or any other client at all, so no prompt, however worded, can reach it.

### What happens to a Fanvue connection when someone leaves?

Offboarding a person in Elaichi ends their access to Fanvue through every client at once. If they were using a shared Fanvue connection, it keeps working for everyone else on the team. If you want Fanvue gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client together.

## All 225 Fanvue tools

Every tool below is callable through https://api.elaichi.ai/mcp once Fanvue is connected, subject to the toolbox it is in and the restrictions on the caller.

- **List all Fanvue agencies team members** (List). 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). 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** (Create). 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** (Create). 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). 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). 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). 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). 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). 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). 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** (List). 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). 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). List fanvue chat conversations with optional filtering, searching, and sorting. Returns: createdAt, lastMessageAt, isRead, isMuted, unreadMessagesCount, user, lastMessage.
- **Create a Fanvue chat** (Create). Create a new fanvue chat conversation with a specified user. Returns: message. Required: userUuid.
- **Fanvue chats list messages** (List). 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). 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** (Create). 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). 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** (Create). 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). 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). 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** (Create). 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). 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). 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). 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** (Create). 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). 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). 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** (List). 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** (List). 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** (Create). 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** (Create). 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** (Create). 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** (Create). 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). 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). 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). 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). 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). 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). Create a new fanvue custom list for organizing contacts. Returns: uuid, name, createdAt. Required: name.
- **Fanvue lists customs list 2** (List). 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** (Update). 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). 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** (Action). 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). 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). 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). 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** (Update). 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). 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** (Action). 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** (Delete). 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** (Delete). 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). 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** (List). 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). Get a single fanvue chat template message by id. Returns: uuid, text, price, mediaUuids, folderName. Required: id.
- **List all Fanvue collections** (List). List fanvue content collections for the authenticated creator. Returns: uuid, label, createdAt.
- **Create a Fanvue collection** (Create). Create a new fanvue content collection for the authenticated creator. Returns: uuid, label, createdAt. Required: label.
- **Update a Fanvue collection by ID** (Update). 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). 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). 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). List fanvue followers for a specified creator. Returns: uuid, handle, displayName, nickname, isTopSpender, avatarUrl, registeredAt. Required: creator_user_uuid.
- **List all Fanvue creator accounts** (List). 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). 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). 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). List fanvue chats for a creator. Returns: createdAt, lastMessageAt, isRead, isMuted, unreadMessagesCount, user, lastMessage. Required: creator_user_uuid.
- **Create a Fanvue creator chat** (Create). 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). 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). 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** (List). 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** (List). 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** (Create). 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** (Create). 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** (List). 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** (List). 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). 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). 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** (List). 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** (List). 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** (List). 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** (List). 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). 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). 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). 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). 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). 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). 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). 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** (List). 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** (List). 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** (List). 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). 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** (Create). 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** (Create). 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). Create a fanvue media record and start an S3 multipart upload session. Returns: mediaUuid, uploadId. Required: name, filename, mediaType.
- **Fanvue media uploads bulk update** (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). 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** (Update). 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** (List). 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** (List). 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). 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). 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** (List). 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). 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** (Delete). 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). 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** (Action). 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). 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). 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). 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). 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). 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** (Create). 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** (Create). 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** (Create). 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** (Delete). 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** (Create). 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** (Delete). 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). 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). 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). 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). 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). 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). 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). 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** (List). 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** (List). 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). 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). 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). Create a new folder in the authenticated fanvue user's vault. Returns: name, createdAt, mediaCount. Required: name.
- **Fanvue vault folders list 2** (List). 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** (Update). 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). 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). 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). Create a new folder in the authenticated fanvue user's vault. Returns: name, createdAt, mediaCount. Required: name.
- **Fanvue vault folders list 4** (List). 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** (Update). 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). 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). Get a single fanvue vault folder by id. Returns: name, createdAt, mediaCount. Required: id.
- **List all Fanvue followers** (List). 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). 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). 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). 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). 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). Delete a fanvue tracking link by id. Returns an empty 204 response on success. Required: id.
- **List all Fanvue users** (List). 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** (List). 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). List the authenticated creator's active webhook subscriptions in fanvue. Returns: id, url, events, createdAt.
- **Create a Fanvue webhooks subscription** (Create). 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). Delete a fanvue webhook subscription by id. Returns an empty 204 response on success. Required: id.
- **List all Fanvue chats smart lists** (List). 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). 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). 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). Create a new custom chat list in fanvue. Returns: uuid, name, memberCount. Required: name.
- **Get single Fanvue chats custom list by ID** (Get). Get a single fanvue custom chat list by id. Returns: uuid, name, memberCount. Required: id.
- **Update a Fanvue chats custom list by ID** (Update). Update a fanvue custom chat list by id. Returns: uuid, name, memberCount. Required: id.
- **Delete a Fanvue chats custom list by ID** (Delete). Delete a fanvue custom chat list by id. Returns an empty 204 response on success. Required: id.
- **Fanvue chats custom lists attach member** (Action). 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** (Action). 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** (List). 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). 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** (Create). 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). 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). List fanvue mass messages for a creator. Returns: id, recipientCount, createdAt. Required: creator_user_uuid.
- **Create a Fanvue creator chats mass message** (Create). 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). 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). 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). List unread chats for a fanvue creator. Returns: uuid. Required: creator_user_uuid.
- **Create a Fanvue creator chats status** (Create). 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** (Create). 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). 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). 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). 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). 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). 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). 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). 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** (Action). 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** (Action). 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). 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). 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). 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). 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** (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). 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** (Create). Add a media item to a fanvue vault folder. Returns: mediaUuid, status. Required: folder_name.
- **Delete a Fanvue vault media by ID** (Delete). 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). List media items in a fanvue creator vault folder. Returns: uuid. Required: creator_user_uuid, folder_name.
- **Create a Fanvue creator vault media** (Create). Add media to a fanvue creator vault folder. Returns: uuid. Required: creator_user_uuid, folder_name.
- **Delete a Fanvue creator vault media by ID** (Delete). 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). 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). 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** (Create). 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** (Create). 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** (List). 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). 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** (Create). 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** (Update). 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** (List). 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** (List). 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). List folders in a fanvue creator's vault. Returns: name. Required: creator_user_uuid.
- **Create a Fanvue creator vault folder** (Create). 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). 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** (Update). 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). 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). List tips received on a specific fanvue creator's post. Returns: id. Required: creator_user_uuid, uuid.
- **List all Fanvue creator post likes** (List). 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). 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** (Create). 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** (Delete). 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). 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). 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** (List). 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** (List). 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). 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). List earnings percentile insights for a fanvue creator. Returns: percentile. Required: creator_user_uuid.
- **List all Fanvue creator insights spendings** (List). 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). 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). 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). 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). 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** (Create). 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). 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). 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** (List). 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** (List). 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.
