# OnlyX Help > Help for OnlyX, the AI chatting and CRM platform for OnlyFans agencies: connect creators, set up Hugo, work the inbox, read your numbers, and build on the OnlyX API and MCP server. > ## Agent Instructions > You are reading OnlyX Help: the OnlyX Help Center and the OnlyX developer documentation. OnlyX is an AI chatting and CRM platform for OnlyFans agencies. Its AI chatter is called Hugo in the app. > Pages at the site root (for example /inbox/..., /hugo/..., /billing/...) are Help Center articles for agency owners, admins, chatters and creators who use the app at app.onlyx.ai. Words in bold are the exact button, menu and label names the app shows; keep them exactly as written. When these pages do not answer a question, the person can email support at support@onlyx.ai. > Pages under /developers are the developer documentation. REST API base URL: https://api.onlyx.ai/v1 (authenticate with `Authorization: Bearer `; keys start with onx_sk_ and are created in app.onlyx.ai under Settings > API & MCP). MCP server: https://mcp.onlyx.ai/mcp (OAuth, or a Bearer API key). In the API the AI chatter is `ai` on the wire. Money is integer US cents in fields ending in Cents; timestamps are UTC ISO-8601. > Rules for assistants acting on a user's behalf: discover ids with list calls and never invent them; before any call that reaches a real fan or the live OnlyFans account (sending a message, releasing a chat to the AI, turning AI on for a chat, resolving a hand-off, turning review mode off, changing the welcome message, creating a tracking link) show the user the exact content and get explicit confirmation; send every POST with an Idempotency-Key and reuse it on retry; never resend a message whose delivery status is unconfirmed; never ask a creator for her OnlyFans password or codes - she signs in herself through a connect link and the OnlyX Login app. - [OnlyX Help Center](https://help.onlyx.ai/index.md): Guides for OnlyFans agencies using OnlyX: connect creators, set up Hugo, work the inbox, read your numbers and manage billing. - [Getting started](https://help.onlyx.ai/getting-started/index.md): Create your agency account, add your first creator and get Hugo answering fans. - [What is OnlyX?](https://help.onlyx.ai/getting-started/what-is-onlyx.md): OnlyX runs your creators' fan conversations with Hugo, the AI chatter. Learn what it does, who answers fans, and what you pay. - [Create your agency account](https://help.onlyx.ai/getting-started/create-your-account.md): Sign up for OnlyX with your name, agency name, Telegram, email and password. You get a new workspace, and you are its owner. - [Confirm your email](https://help.onlyx.ai/getting-started/confirm-your-email.md): Open the link that OnlyX emails you within 7 days, or send yourself a new one, so that OnlyX stays open for you. - [Quick start: from sign-up to Hugo answering](https://help.onlyx.ai/getting-started/quick-start.md): The shortest path from a new workspace to Hugo answering your first creator's fans and selling her content. - [Add your first creator](https://help.onlyx.ai/getting-started/add-your-first-creator.md): Add a creator to OnlyX: give her a name, a colour and a platform, then connect her OnlyFans or Telegram account. - [Find your way around OnlyX](https://help.onlyx.ai/getting-started/find-your-way-around.md): Learn where everything is in OnlyX: the sidebar, the phone tab bar, the creator switcher, the SFW blur, the theme and your account menu. - [Invite your team](https://help.onlyx.ai/getting-started/invite-your-team.md): Invite admins, chatters and content VAs to your workspace, and choose which creators each chatter or content VA works on. - [Turn Hugo on for a creator](https://help.onlyx.ai/getting-started/turn-hugo-on.md): Find Hugo's switch for a creator, and read what her Overview says: Hugo is answering, on and held back, or off. - [Add credits so Hugo can sell](https://help.onlyx.ai/getting-started/add-credits.md): Top up your OnlyX balance with USDT or USDC, and learn what happens when your credits run out. - [Find, sort and label your creators](https://help.onlyx.ai/getting-started/organize-creators.md): Search, sort and switch how your creator roster looks, and give an OnlyFans creator a label and color tag your team sees. - [Your first shift as a chatter](https://help.onlyx.ai/getting-started/your-first-shift.md): Work your first shift in the OnlyX inbox: choose what to answer first, check who has a conversation, reply, leave a note and give it back to Hugo. - [Move an existing creator or agency to OnlyX](https://help.onlyx.ai/getting-started/move-to-onlyx.md): Connect a creator's existing OnlyFans account, set up your team, persona and content, then turn Hugo on when you are ready. - [Connecting OnlyFans accounts](https://help.onlyx.ai/connecting/index.md): Connect a creator's OnlyFans account, pass the face check and reconnect a creator who signed out. - [Choose how to connect an OnlyFans account](https://help.onlyx.ai/connecting/ways-to-connect.md): Compare Connect here, Connect with App and Connect with proxy, and pick the one that fits the creator's device and the face check. - [Send your creator a setup link](https://help.onlyx.ai/connecting/send-a-setup-link.md): Copy the creator's setup link and send it to her, so she signs in to OnlyFans herself in the OnlyX Login app. No password sharing. - [Connect with proxy (Happ)](https://help.onlyx.ai/connecting/connect-with-proxy.md): Sign a creator in yourself while her phone runs Happ, so she can pass the OnlyFans face check on her own phone. Works for Android. - [Sign in yourself with Connect here](https://help.onlyx.ai/connecting/connect-here.md): Sign a creator in to OnlyFans yourself, in her own browser inside OnlyX, and learn how to paste into it and when the window closes. - [OnlyFans face check and Verification required](https://help.onlyx.ai/connecting/face-check.md): Learn which ways to connect can pass the OnlyFans face check, and how to clear a creator who shows Verification required. - [Connection statuses explained](https://help.onlyx.ai/connecting/connection-statuses.md): Learn what Connected, Verification required, Signed out, Disconnected, Not a creator account and Already connected mean, and how to fix each one. - [Reconnect a signed-out creator](https://help.onlyx.ai/connecting/reconnect-a-creator.md): Sign a creator back in after OnlyFans signed her out, so her inbox syncs and Hugo replies again. Also covers the Creator signed out alert. - [Why doesn't her connect link work?](https://help.onlyx.ai/connecting/connect-link-problems.md): Fix setup links, proxy links and app sign-in links that do not work: expired, used, cancelled, pasted in the wrong place or opened on the wrong device. - [Choose a creator's preferred location](https://help.onlyx.ai/connecting/preferred-location.md): Pick the country that a new creator's OnlyFans browser runs from, and learn what happens when no address is free in that country. - [Open browser, Disconnect or Delete a creator](https://help.onlyx.ai/connecting/disconnect-or-delete.md): Learn what Open browser, Disconnect and Delete creator do, which one keeps the creator's data, and why the Danger zone button deletes. - [For creators](https://help.onlyx.ai/for-creators/index.md): Pages to send to your creators: sign in with OnlyX Login, set up Happ and record a voice sample. - [Sign in with OnlyX Login on a Mac](https://help.onlyx.ai/for-creators/onlyx-login-mac.md): Install the free OnlyX Login app on your Mac, then sign in to OnlyFans yourself from the link your agency sent you. - [Sign in with OnlyX Login on Windows](https://help.onlyx.ai/for-creators/onlyx-login-windows.md): Install the free OnlyX Login app on your Windows PC, get past the Windows warning, and sign in to OnlyFans yourself. - [Sign in with OnlyX Login on iPhone (TestFlight)](https://help.onlyx.ai/for-creators/onlyx-login-iphone.md): Install OnlyX Login on your iPhone through Apple's TestFlight app, then sign in to OnlyFans yourself from your agency's link. - [Put your phone on the OnlyX network with Happ](https://help.onlyx.ai/for-creators/happ-proxy.md): Set up the free Happ app so your phone is on the OnlyX network, then do the OnlyFans face check your agency sends you. - [Record your voice for AI voice notes](https://help.onlyx.ai/for-creators/record-your-voice.md): Read a short script out loud on your phone, from the link your agency sent, so OnlyX can make an AI copy of your voice. - [Face check tips and what OnlyX can see](https://help.onlyx.ai/for-creators/face-check-tips.md): Do the OnlyFans face check on the right device, fix the messages OnlyX Login shows, and learn what OnlyX can and cannot see. - [Telegram creators](https://help.onlyx.ai/telegram/index.md): Connect a Telegram creator, set up Stripe payments and upload her media. - [Telegram creators: how they differ](https://help.onlyx.ai/telegram/how-telegram-creators-differ.md): What changes when a creator's fans are on Telegram: how she connects, her Payments and Media tabs, seven setup steps and a few smaller differences. - [Connect a managed Telegram account](https://help.onlyx.ai/telegram/connect-a-managed-account.md): Give a Telegram creator a managed account that is already signed in. You pick it from a list, and she is connected at once, with no code to type. - [Connect her own Telegram account](https://help.onlyx.ai/telegram/connect-her-own-account.md): Sign in to a creator's own Telegram account from OnlyX with her phone number and the code Telegram sends her. Reconnect it when Telegram signs it out. - [Edit a Telegram creator's profile](https://help.onlyx.ai/telegram/edit-the-profile.md): Change the name, @username, bio and photo that fans see on her Telegram account, and the name your team sees in OnlyX. - [Connect Stripe payments](https://help.onlyx.ai/telegram/connect-stripe.md): Connect a Telegram creator's own Stripe account so fans can pay to unlock her content. Change the keys later, or disconnect them. - [Upload media for a Telegram creator](https://help.onlyx.ai/telegram/upload-media.md): Upload a Telegram creator's photos and videos to her Media tab, tag them and delete them. Hugo sells them once you add them to AI Content. - [A Telegram fan paid but cannot open the content](https://help.onlyx.ai/telegram/paid-content-not-unlocked.md): Find the fan's paid offer in the inbox, read its label, check the money and the delivery, and know when to email support with the right details. - [Setting up Hugo](https://help.onlyx.ai/hugo/index.md): Teach Hugo who each creator is, how she writes and what she will never do. - [How Hugo works](https://help.onlyx.ai/hugo/how-hugo-works.md): What Hugo does when a fan writes, what he sells, what stops him, and when your team takes over a conversation. - [Get a creator ready for Hugo](https://help.onlyx.ai/hugo/setup-checklist.md): Use the checklist on a creator's Overview to see what Hugo still needs, fix each step, and know when he can answer and sell. - [AI Persona: tell Hugo who she is](https://help.onlyx.ai/hugo/persona-identity.md): Fill in the Identity section of AI Persona: the name, age, city, job and backstory Hugo needs to speak as the creator. - [AI Persona: set how she writes](https://help.onlyx.ai/hugo/persona-voice.md): Choose the creator's archetype and writing style in the Voice section of AI Persona, and paste her own words so Hugo sounds like her. - [Set hard limits and soft boundaries](https://help.onlyx.ai/hugo/hard-limits-and-soft-boundaries.md): Tell Hugo what the creator never does and what she steers away from, then save so the limits are in force. - [Escalation policy: choose what goes to your team](https://help.onlyx.ai/hugo/escalation-policy.md): Choose, for each creator, which situations Hugo escalates to your team and which he steers away from himself. - [AI Follow-ups: let Hugo write first](https://help.onlyx.ai/hugo/ai-follow-ups.md): Let Hugo write first to fans who went quiet, choose how many follow-ups a fan can get each day, and check what went out. - [AI Rules: automate what happens to a fan](https://help.onlyx.ai/hugo/ai-rules.md): Make rules that act on a fan for you: turn Hugo off for one fan, follow new fans back, add fans to a list or send a webhook. - [AI voice notes: give Hugo her voice](https://help.onlyx.ai/hugo/ai-voice-notes.md): Record the creator's voice with a link or a file, listen to the sample lines, then let Hugo send voice notes in her voice. - [Custom Content: prices, menu and orders](https://help.onlyx.ai/hugo/custom-content.md): Record a creator's custom prices and menu, send custom requests to your team, and work through paid custom orders. - [AI Mass DMs: message whole lists](https://help.onlyx.ai/hugo/ai-mass-dms.md): Let Hugo send one message in the creator's voice to whole OnlyFans lists on a schedule, and choose which lists never get it. - [AI Content](https://help.onlyx.ai/ai-content/index.md): Choose what Hugo can sell: build collections, set levels and prices, and fix what he cannot send. - [How AI Content works: groups, collections and levels](https://help.onlyx.ai/ai-content/how-ai-content-works.md): Learn how AI Content decides what Hugo can sell: groups, collections, levels, teasers, paid pieces and price floors. - [Build your first collection](https://help.onlyx.ai/ai-content/build-your-first-collection.md): Set up a collection by hand: name it, add levels with prices, and place a teaser and paid files from the vault so Hugo can sell them. - [Levels: teasers, paid pieces, openers and aftercare](https://help.onlyx.ai/ai-content/levels.md): Set up each level: its teaser and paid pieces, its name and About, free openers and aftercare, and what its numbers mean. - [Story or Menu: choose how Hugo walks a collection](https://help.onlyx.ai/ai-content/story-vs-menu.md): Choose Story or Menu for each collection: see how Hugo offers the levels in each mode, and how to change the mode or the order of the levels. - [Set price floors and tags](https://help.onlyx.ai/ai-content/prices-and-tags.md): Set the price floor Hugo never sells a whole level below, and add tags that help him match a level to what a fan asks for. - [Fix "Nothing sellable yet" and other level warnings](https://help.onlyx.ai/ai-content/level-states.md): See what each level badge and collection dot means, fix the levels Hugo cannot sell, and get the Map the content step marked Done. - [Work faster: shortcuts, focus mode, pause and undo](https://help.onlyx.ai/ai-content/shortcuts-and-focus-mode.md): Map content faster with keyboard shortcuts and Focus mode, pause instead of deleting, undo a delete, and keep collections tidy with groups. - [OnlyFans tools](https://help.onlyx.ai/onlyfans-tools/index.md): Use each OnlyFans creator's vault, earnings, fans and tracking links. - [The Vault: sync and browse](https://help.onlyx.ai/onlyfans-tools/vault.md): See an OnlyFans creator's media library in OnlyX, bring it up to date, find a file and label it with your own tags. - [Upload to the Vault](https://help.onlyx.ai/onlyfans-tools/upload-to-the-vault.md): Add photos, videos and audio to an OnlyFans creator's vault from OnlyX. Files are added privately: nothing is posted and no message is sent. - [Earnings: see what a creator earned](https://help.onlyx.ai/onlyfans-tools/earnings.md): Read an OnlyFans creator's earnings in OnlyX: what she can withdraw, what is pending, net and gross totals, and every payment, fan by fan. - [Fans: lists, smart lists and filters](https://help.onlyx.ai/onlyfans-tools/fans.md): See a creator's whole audience, open her OnlyFans lists or OnlyX smart lists, filter and sort her fans, and jump to a fan's conversation. - [Create tracking links and free trial links](https://help.onlyx.ai/onlyfans-tools/tracking-links.md): Make an OnlyFans tracking link or free trial link from OnlyX, keep its numbers fresh, and delete a tracking link you no longer use. - [Measure promotions and share results with promoters](https://help.onlyx.ai/onlyfans-tools/measure-promotions.md): Tag each tracking link with its source and cost, compare profit, ROI and cost per fan, and give a promoter a page with one link's results. - [See the welcome message new fans get](https://help.onlyx.ai/onlyfans-tools/welcome-message.md): Check the automatic message OnlyFans sends every new fan of a creator: its words, attachments, price and switch, and read it again from OnlyFans. - [Inbox](https://help.onlyx.ai/inbox/index.md): Answer fans, take over from Hugo, handle escalations and send PPVs from one inbox. - [Inbox tour: the list, the conversation and the fan panel](https://help.onlyx.ai/inbox/inbox-tour.md): Learn the three parts of the Inbox, what each mark on a conversation row means, and how the Inbox looks on a laptop and a phone. - [Conversation states: Hugo, Manual, Escalated and Hugo off](https://help.onlyx.ai/inbox/conversation-states.md): Learn who answers a fan in each conversation state, and how a conversation moves between Hugo and your team. - [Take over a conversation and give it back](https://help.onlyx.ai/inbox/take-over-and-resume-hugo.md): Answer a fan yourself, then give the conversation back to Hugo when you are done. - [Keep Hugo out of one fan's conversation](https://help.onlyx.ai/inbox/keep-hugo-out-of-a-chat.md): Turn Hugo off for one fan, so only your team answers him, and turn Hugo back on when you are ready. - [Handle an escalation](https://help.onlyx.ai/inbox/handle-an-escalation.md): Read why Hugo escalated a conversation, then give it back to Hugo or answer the fan yourself. - [Find conversations: search, filters and sort](https://help.onlyx.ai/inbox/find-conversations.md): Narrow the Master Inbox to the conversations worth answering now: by creator, state, fan name, kind of fan and order. - [Send a message and add emoji](https://help.onlyx.ai/inbox/send-messages.md): Write to a fan from the message box of an open conversation, add emoji, and know what happens to your draft. - ["Hugo will not answer this thread"](https://help.onlyx.ai/inbox/hugo-will-not-answer.md): Learn what stops Hugo in a conversation that shows Hugo will not answer this thread, fix it, and look after the fan meanwhile. - [Send a PPV or free media from the vault](https://help.onlyx.ai/inbox/send-a-ppv.md): Pick media from the creator's vault in a conversation, lock some of it behind a price, and send it to the fan as a PPV or as free media. - [Message delivery states: did the fan get it?](https://help.onlyx.ai/inbox/delivery-states.md): Learn what in queue, sending, never sent and not delivered mean under a message, what the fan can see, and what to do. - [Copy, quote, hide, tag or unsend a message](https://help.onlyx.ai/inbox/message-actions.md): Use the menu on each message to copy it, quote it in a reply, hide or tag it for your team, or unsend it on OnlyFans within 24 hours. - [The fan panel: know the fan before you reply](https://help.onlyx.ai/inbox/fan-panel.md): Read who the fan is, what he spent and what your team knows about him, then rename him, mute him or write notes for the team. - [What Hugo knows about a fan](https://help.onlyx.ai/inbox/what-hugo-knows.md): Read what Hugo has told a fan as the creator, what he knows about the fan and what he plans next, before you answer the fan yourself. - [See and cancel Hugo's scheduled follow-ups](https://help.onlyx.ai/inbox/scheduled-follow-ups.md): See the messages Hugo plans to send a fan on his own, and cancel one before it goes out. - [Translate conversations into your language](https://help.onlyx.ai/inbox/translate.md): Read fans who write in another language: translate one conversation, or every conversation you open, into the language you choose. - [Rate Hugo's messages](https://help.onlyx.ai/inbox/rate-hugos-messages.md): Give one of Hugo's messages a score from 1 to 10 with notes on what was good or bad, and see what your team thought of it. - [Read a fan's activity timeline](https://help.onlyx.ai/inbox/fan-activity.md): See what a fan is worth and what happened with him: sales, tips, who handled the conversation, escalations and Hugo's follow-ups. - [Use the inbox on your phone](https://help.onlyx.ai/inbox/inbox-on-your-phone.md): Answer fans from your phone's browser: open a conversation, go back to the list, see the fan panel and find the other pages. - [Why isn't Hugo replying?](https://help.onlyx.ai/inbox/hugo-isnt-replying.md): See why Hugo is not answering a fan, from the conversation, the creator's setup or billing, and fix it. - [Find older messages and understand missing history](https://help.onlyx.ai/inbox/older-and-missing-messages.md): Scroll back through a conversation, and learn what the earlier-messages hint, the history banner and hidden messages mean. - [Dashboard & Analytics](https://help.onlyx.ai/analytics/index.md): Read your earnings, fans and chat activity, and see what is waiting on you. - [The Dashboard: your agency at a glance](https://help.onlyx.ai/analytics/dashboard.md): See how today is going, what needs a person, and what your creators earned. Learn which controls change which card. - [Waiting on you: what needs a person](https://help.onlyx.ai/analytics/waiting-on-you.md): Learn what each row of the Dashboard's Waiting on you card means, where it takes you, and why unread conversations are not on it. - [Net or gross, periods and the reporting timezone](https://help.onlyx.ai/analytics/net-gross-and-periods.md): Choose Net or Gross, pick the period a report covers, and set the timezone that decides where each report day starts and ends. - [Revenue overview: what your creators earned](https://help.onlyx.ai/analytics/revenue-overview.md): Read your creators' earnings for a period: the four tiles, the daily chart, Payment status, the By creator table and Who paid. - [Today: how today compares with yesterday](https://help.onlyx.ai/analytics/today.md): Compare today so far with yesterday at the same time, learn what each Today number counts, and open the records behind any hour. - [Fans report: active fans, new fans and your fan base](https://help.onlyx.ai/analytics/fans-report.md): See how many fans are chatting and coming back, how many new fans arrived, and what your fan base looks like now. - [Content sales and Chat activity reports](https://help.onlyx.ai/analytics/content-sales-and-chat-activity.md): See how your PPVs perform, which prices and media get opened, how fast fans get a reply, and who answers them: Hugo or your team. - [Open the records behind a number and export CSV](https://help.onlyx.ai/analytics/records-and-csv-export.md): Open the sales, fans or messages behind any Analytics figure, find the rows you need, and download a table or a list as a CSV file. - [Why numbers differ between screens](https://help.onlyx.ai/analytics/why-numbers-differ.md): Match the figures on the Dashboard, in Analytics, on a creator's Earnings tab, in the fan panel and in Billing, and see why they differ. - [Billing & credits](https://help.onlyx.ai/billing/index.md): See how billing works, add credits with USDT or USDC, and keep Hugo selling. - [How billing works](https://help.onlyx.ai/billing/how-billing-works.md): What OnlyX charges for and when: 10% of the net on each PPV that Hugo sells, taken from your prepaid credits once a day. - [Add credits with USDT or USDC](https://help.onlyx.ai/billing/add-credits.md): Top up your prepaid OnlyX balance with a USDT or USDC deposit: pick an amount and a network, send exactly that amount, and wait for the credit. - [Low balance, grace period and "Hugo is paused"](https://help.onlyx.ai/billing/low-balance-and-pause.md): What Running low, Grace period and Hugo is paused mean on the Billing page, how long the grace period lasts, and how to get Hugo working again. - [Your balance: Credits, Pending usage and Net balance](https://help.onlyx.ai/billing/your-balance.md): Read the three numbers on the Balance card, see which one to watch, and see what Hugo costs for each creator. - [Check your usage report and transactions](https://help.onlyx.ai/billing/usage-and-transactions.md): See every sale Hugo was charged for, read your balance history, and trace each daily charge back to the sales in it. - [Billing emails and alerts](https://help.onlyx.ai/billing/billing-alerts.md): The five billing alerts OnlyX sends to owners and admins, when each one arrives, and how to turn them on or off for email and Telegram. - [Team & workspace](https://help.onlyx.ai/team/index.md): Invite your team, choose their roles and pick which creators each person works on. - [What each team role can see and do](https://help.onlyx.ai/team/roles-and-permissions.md): Compare the owner, admin, chatter and content VA roles: the pages, creators and controls each role gets in OnlyX. - [Manage members, assignments and invites](https://help.onlyx.ai/team/manage-members.md): Invite people, change their role, choose which creators they work on, remove them, and resend or revoke invites in Settings > Members. - [Rename your workspace and set its reporting timezone](https://help.onlyx.ai/team/workspace-settings.md): Change your workspace's name, and set the reporting timezone that decides where each day starts in your whole team's reports. - [Work in several workspaces](https://help.onlyx.ai/team/several-workspaces.md): Switch between the workspaces you belong to from the account menu, or create a new workspace of your own. - [Leave a workspace](https://help.onlyx.ai/team/leave-a-workspace.md): Leave a workspace you no longer work in. Learn why the owner cannot leave, and how to ask for a workspace to be closed. - [Join a team from an invite](https://help.onlyx.ai/team/join-from-an-invite.md): Accept an invite to an agency's OnlyX workspace: create your account, or join with the account you already have. - [Account, security & notifications](https://help.onlyx.ai/account/index.md): Keep your account safe with two-factor authentication, and choose the alerts you get. - [Change or reset your password](https://help.onlyx.ai/account/password.md): Change your OnlyX password in Settings, or reset a forgotten one with an emailed link that works once, for 60 minutes. - [Two-factor authentication and recovery codes](https://help.onlyx.ai/account/two-factor-authentication.md): Turn on two-factor sign-in with an authenticator app, save your recovery codes, sign in with a code, make new codes or turn it off. - [Check your active sessions and sign-in alerts](https://help.onlyx.ai/account/active-sessions.md): See every device signed in to your OnlyX account, sign one out or all the others, and understand the New sign-in email. - [Change your profile, theme and inbox display](https://help.onlyx.ai/account/profile-and-appearance.md): Set your name and Telegram contact, pick light or dark mode, blur photos and video, and choose what conversations show you and in which language. - [Connect the Telegram notifications bot](https://help.onlyx.ai/account/telegram-bot.md): Pair the OnlyX bot @onlyx_aibot with your account to get OnlyX alerts in Telegram, send a test message, and disconnect when you want. - [Choose your notifications](https://help.onlyx.ai/account/notifications.md): Pick which OnlyX alerts reach you by email and on Telegram, for every creator or only some. Only owners and admins receive them. - [Emails OnlyX sends you](https://help.onlyx.ai/account/emails.md): Every email OnlyX sends about your own account, what each one means, how long its link works, and how to spot an email that is not from OnlyX. - [What OnlyX support can and cannot do in your workspace](https://help.onlyx.ai/account/support-sessions.md): When OnlyX support checks a problem in your workspace: how long it lasts, read-only or with changes, and what stays locked. - [Referrals & developers](https://help.onlyx.ai/referrals-and-developers/index.md): Earn with your referral link, and connect OnlyX to AI assistants and your own tools. - [Earn rewards by referring other agencies](https://help.onlyx.ai/referrals-and-developers/referral-program.md): Share your invite link with other agencies and earn 10% of every deposit they make. Learn how sign-ups are counted and what you agree to. - [Transfer or withdraw referral rewards](https://help.onlyx.ai/referrals-and-developers/transfer-or-withdraw-rewards.md): Move your referral rewards into your OnlyX balance to pay for Hugo, or withdraw them in USDT on TRON. Both need a balance of at least $100. - [Use OnlyX from Claude, ChatGPT, Cursor or VS Code](https://help.onlyx.ai/referrals-and-developers/connect-an-ai-assistant.md): Connect Claude, ChatGPT, Cursor, VS Code or Claude Code to your workspace, then approve it on the OnlyX page and choose the creators it may use. - [Create and manage API keys](https://help.onlyx.ai/referrals-and-developers/api-keys.md): Create an API key for your own tools, choose what it may do and which creators it sees, then rename or revoke it. Keys belong to the workspace. - [See and disconnect connected apps](https://help.onlyx.ai/referrals-and-developers/connected-apps.md): See which AI assistants can use your workspace, what they may do and who approved them, and disconnect any of them at once. - [OnlyX Developers](https://help.onlyx.ai/developers/index.md): Run your OnlyFans agency from code or from your AI assistant: creators, inbox, sending, fans, stats, and the AI chatter's persona and content. - [Quickstart](https://help.onlyx.ai/developers/quickstart.md): Create an API key, check it with GET /v1/me, list creators, read the inbox and send a first message. - [Authentication](https://help.onlyx.ai/developers/authentication.md): API keys and OAuth tokens: format, scopes, presets, creator restrictions, expiry, revocation, and the 401 and 403 errors. - [Workspaces](https://help.onlyx.ai/developers/concepts/workspaces.md): The workspace is your agency's account in OnlyX. Keys, OAuth connections, creators and all data belong to exactly one workspace. - [Creators](https://help.onlyx.ai/developers/concepts/creators.md): A creator is one OnlyFans or Telegram account your workspace manages: its connection status, AI switch, readiness checks and headline stats. - [Conversations](https://help.onlyx.ai/developers/concepts/conversations.md): One chat between a creator and a fan. Its status says who answers it: the AI, your team, a hand-off, or nobody automatic. - [Hugo, the AI chatter](https://help.onlyx.ai/developers/concepts/hugo-ai.md): What OnlyX's AI chatter does for each creator, when it hands a chat to your team, and every switch that controls it. - [AI persona](https://help.onlyx.ai/developers/concepts/ai-persona.md): Every field of a creator's AI persona: who she is, how she writes, what she will never do, and when the AI hands off. With good and bad examples. - [AI content](https://help.onlyx.ai/developers/concepts/ai-content.md): Ladders, levels, free openers and aftercare, price floors in cents, preview versus paid media, and how the AI decides what to offer. - [Add a creator](https://help.onlyx.ai/developers/guides/add-a-creator.md): Add an OnlyFans creator through the API, send her setup link and poll until she is connected: the three connect methods, the OnlyX Login app, the face check, and Telegram creators. - [Read and send messages](https://help.onlyx.ai/developers/guides/read-and-send-messages.md): List and filter conversations, read message history, send text, free vault media and paid messages with an Idempotency-Key, track delivery, and take over or release chats. - [Handle hand-offs](https://help.onlyx.ai/developers/guides/handoffs.md): Find the chats the AI handed to your team, understand why, reply, and resolve the hand-off so the AI can take the chat back. - [Work with fans](https://help.onlyx.ai/developers/guides/fans.md): Find fans by segment, spend and subscription status, read a fan's purchases, and keep your team's notes, custom names and mute flags. - [Use vault media](https://help.onlyx.ai/developers/guides/vault-media.md): Browse a creator's OnlyFans vault, fetch thumbnails, and use media ids in messages and AI content levels. - [Pull stats](https://help.onlyx.ai/developers/guides/pull-stats.md): Today's numbers, revenue by type, day and seller, audience, the cached overview report with its 202 warming loop, and each creator's transaction ledger. - [Set up the AI persona](https://help.onlyx.ai/developers/guides/ai-persona.md): Read and update a creator's AI persona with GET and PATCH: partial updates, null to clear, validation limits, a complete example, and readiness. - [Build the AI content ladder](https://help.onlyx.ai/developers/guides/ai-content.md): Step by step with real calls: find vault media, create a folder and a ladder, add priced and free levels, attach preview and paid media, reorder, verify and switch it on. - [Tune AI settings](https://help.onlyx.ai/developers/guides/ai-settings.md): Turn the AI on or off per creator, configure follow-ups and review mode (turning it off releases waiting drafts), and read or replace the OnlyFans welcome message with dry runs. - [Track promotion links](https://help.onlyx.ai/developers/guides/tracking-links.md): List a creator's OnlyFans tracking and trial links with clicks, subscribers, earnings, cost and ROI; record cost and source; create new links with a 202 and poll. - [Using OnlyX with Claude and other assistants](https://help.onlyx.ai/developers/guides/using-with-claude.md): Prompt recipes for Claude, ChatGPT, Cursor and other MCP clients: daily briefing, replying to unread fans safely, onboarding a creator, building a persona and a ladder, and a weekly revenue report. - [Errors](https://help.onlyx.ai/developers/errors.md): The error envelope, every public error code with its HTTP status, meaning and fix, and which errors are safe to retry. - [Rate limits](https://help.onlyx.ai/developers/rate-limits.md): Every limit on the OnlyX API, the X-RateLimit headers, the 429 response with Retry-After, and a backoff example. - [Pagination](https://help.onlyx.ai/developers/pagination.md): How list endpoints page with limit, cursor, hasMore and nextCursor, the page sizes per endpoint, and how message history pages backwards with before. - [Idempotency](https://help.onlyx.ai/developers/idempotency.md): Use the Idempotency-Key header so a retried write never runs twice: format, which endpoints require it, replays, conflicts and the 24-hour window. - [Security](https://help.onlyx.ai/developers/security.md): How OnlyX protects API access and your agency's data: workspace-owned keys hashed at rest, scopes and creator restrictions, OAuth consent, tenant isolation, what the API never returns, and how to report a vulnerability. - [Coming soon](https://help.onlyx.ai/developers/coming-soon.md): What the OnlyX API and MCP server do not do yet, and what is on the way: webhooks, mass messages, vault uploads, posts, account lifecycle, money, promotions, team metrics and developer tooling. - [Changelog](https://help.onlyx.ai/developers/changelog.md): New features, changes and fixes in the OnlyX API and MCP server. - [OnlyX MCP server](https://help.onlyx.ai/developers/mcp/overview.md): Connect Claude, ChatGPT, Cursor, VS Code and other AI assistants to OnlyX at https://mcp.onlyx.ai/mcp. OAuth or API key, what the tools can do, and how the server keeps you safe. - [Claude](https://help.onlyx.ai/developers/mcp/claude.md): Add OnlyX to Claude as a custom connector in one click, sign in with OAuth, and use it on claude.ai, Claude Desktop and the mobile apps. Includes Team and Enterprise setup. - [ChatGPT](https://help.onlyx.ai/developers/mcp/chatgpt.md): Connect OnlyX to ChatGPT as a Developer mode app with the URL https://mcp.onlyx.ai/mcp and OAuth sign-in. - [Cursor](https://help.onlyx.ai/developers/mcp/cursor.md): Install the OnlyX MCP server in Cursor with one click, or with a few lines of mcp.json, using OAuth or an API key. - [VS Code](https://help.onlyx.ai/developers/mcp/vscode.md): Add the OnlyX MCP server to VS Code (GitHub Copilot agent mode) with one click, one command, or mcp.json, using OAuth or an API key. - [Claude Code](https://help.onlyx.ai/developers/mcp/claude-code.md): Add the OnlyX MCP server to Claude Code with one command, sign in with /mcp, or use an API key header. Includes scopes, team setup and prompts as slash commands. - [Other clients](https://help.onlyx.ai/developers/mcp/other-clients.md): Connect OnlyX to Windsurf, Gemini CLI, OpenAI Codex, or any MCP client with a JSON configuration and a Bearer header. - [Tools and prompts](https://help.onlyx.ai/developers/mcp/tools.md): Every tool the OnlyX MCP server offers, the API call behind it, the scope it needs, its key inputs, and whether it reaches a real fan or the live OnlyFans account. Plus the six built-in prompts. - [API reference](https://help.onlyx.ai/developers/api-reference/introduction.md): Every endpoint of the OnlyX REST API v1: base URL, authentication, versioning, conventions, pagination, errors, rate limits and idempotency, then one page per operation. - [Get the current workspace and credential](https://help.onlyx.ai/developers/api-reference/workspace/get-the-current-workspace-and-credential.md): Returns the workspace this API key or access token belongs to, what it is allowed to do (its scopes and, if it is limited to some creators, which ones) and the default rate limit that applies to it. Every valid credential may call this endpoint — `workspace:read` is granted implicitly — so it is the… - [List creators](https://help.onlyx.ai/developers/api-reference/creators/list-creators.md): Lists every creator this credential can see, oldest first, with the connection status, the AI switch and headline stats (fans, conversations, unread conversations, open hand-offs, earnings). A key limited to some creators lists only those. Page through with `limit` (up to 100) and the `nextCursor` o… - [Get a creator](https://help.onlyx.ai/developers/api-reference/creators/get-a-creator.md): Returns one creator plus `readiness`: whether she is set up well enough for the AI chatter to chat and sell (OnlyFans connected, persona, hard limits, fans synced, content mapped), with a hint for each check that fails. Use it after onboarding to see what is still missing. Reading a creator never ch… - [Add a creator](https://help.onlyx.ai/developers/api-reference/creators/add-a-creator.md): Adds an OnlyFans creator to your workspace. She starts `disconnected`: next, create a connect link (`POST /v1/creators/{creatorId}/connect-link`) and send it to her so she can sign in to OnlyFans herself. The API never takes her OnlyFans password or codes. Only OnlyFans creators can be added in v1 (… - [Update a creator](https://help.onlyx.ai/developers/api-reference/creators/update-a-creator.md): Renames a creator (`displayName`) or switches her AI chatter on or off (`aiEnabled`). Send only the fields you want to change; any other field, including the connection status, is refused with `400 VALIDATION_ERROR` because it can never be written. Turning `aiEnabled` on reaches real fans: the AI st… - [Get the connection status](https://help.onlyx.ai/developers/api-reference/connect/get-the-connection-status.md): Returns the creator's OnlyFans connection in detail: the status, OnlyX's own explanation, the `nextStep` to take, and the progress of the sync that runs after she connects. Each call checks the live connection, so poll it every 10 seconds or more while she signs in through her connect link, until `s… - [Get the connect link](https://help.onlyx.ai/developers/api-reference/connect/get-the-connect-link.md): Returns the creator's current connect link: whether one is active, its URL and expiry, and how often it was opened. `status` is `none` when no link was ever created, and `url` is only present while the link is `active`. A rising `opens` count you do not expect is a sign the link was shared further t… - [Create a connect link](https://help.onlyx.ai/developers/api-reference/connect/create-a-connect-link.md): Creates a one-time link the creator opens on her own phone or computer to connect her OnlyFans account. She needs no OnlyX account: she signs in to OnlyFans herself with the OnlyX Login app, entering her password, any 2FA or e-mail code, and completing OnlyFans' face (selfie) verification with her o… - [Revoke the connect link](https://help.onlyx.ai/developers/api-reference/connect/revoke-the-connect-link.md): Revokes every unused connect link of this creator, so nobody can start a sign-in with them. Use it when a link went to the wrong person or `opens` looks suspicious, then create a new one. Revoking is idempotent (revoking nothing succeeds) and does not disconnect a creator who is already connected. - [List conversations](https://help.onlyx.ai/developers/api-reference/conversations/list-conversations.md): Lists conversations across every creator the credential can see, or one creator's with `creatorId`. Filter by `status` to find chats your team holds (`team`), chats waiting on a hand-off (`handoff`) or chats with the AI off (`ai_off`); `unread=true` finds fans waiting for an answer, and the two comb… - [Count conversations](https://help.onlyx.ai/developers/api-reference/conversations/count-conversations.md): Returns how many conversations are in each status, and how many have unread fan messages, for every visible creator or for one with `creatorId`. Use it for badges and dashboards instead of paging through the list. It scans the whole inbox, so it has its own limit of 30 calls per 60 seconds per crede… - [Get a conversation](https://help.onlyx.ai/developers/api-reference/conversations/get-a-conversation.md): Returns one conversation with the full fan (subscription, spend, notes, lists and `salesOptOut`), the open hand-off if there is one, and `aiCanReply`: whether the AI would answer this chat right now. Read it before writing to a fan so you know who you are talking to and whether a paid message is all… - [Mark a conversation read](https://help.onlyx.ai/developers/api-reference/conversations/mark-a-conversation-read.md): Marks every fan message in the conversation as read in OnlyX, so `unreadCount` becomes 0. It changes only OnlyX's inbox state: nothing is sent to the fan, no read receipt is shown, and nothing changes on OnlyFans. - [Mark a conversation unread](https://help.onlyx.ai/developers/api-reference/conversations/mark-a-conversation-unread.md): Marks the conversation as unread in OnlyX so it shows up again for your team, for example to flag it for follow-up. It changes only OnlyX's inbox state; nothing is sent to the fan. - [Take over a conversation](https://help.onlyx.ai/developers/api-reference/conversations/take-over-a-conversation.md): Gives the conversation to your team: its status becomes `team`, and the AI stops replying and withdraws any reply it had waiting in it until `takenOverUntil`, after which the chat returns to the AI on its own. Use it before your team works a chat, or to keep the AI out of a delicate conversation. `h… - [Release a conversation to the AI](https://help.onlyx.ai/developers/api-reference/conversations/release-a-conversation-to-the-ai.md): Gives a conversation your team holds back to the AI now: its status becomes `ai`. **This can reach the fan right away**: if the fan's last message is unanswered, the AI may reply to it within seconds, so confirm with a person before releasing on someone's behalf. If the creator's AI is switched off,… - [Switch the AI on or off for a conversation](https://help.onlyx.ai/developers/api-reference/conversations/switch-the-ai-on-or-off-for-a-conversation.md): Switches the AI chatter on or off for this one conversation. `enabled: false` sets the status to `ai_off`: the AI never answers this fan until it is switched back on. `enabled: true` gives the chat to the AI, which **can reach the fan at once**: the AI may immediately answer a waiting message, so co… - [List messages](https://help.onlyx.ai/developers/api-reference/messages/list-messages.md): Returns the conversation's messages, oldest to newest, the newest page first. To read further back, pass the id of the oldest message you have as `before`; `hasMore` tells you whether older messages exist. Outgoing messages carry `delivery`, and paid messages show whether the fan unlocked them. A `b… - [Get a message](https://help.onlyx.ai/developers/api-reference/messages/get-a-message.md): Returns one message. Use it to follow a message you sent: poll every few seconds until `delivery.status` leaves `queued`. On `unconfirmed`, never resend automatically: the fan usually received it. A message that is not in this conversation is `404 MESSAGE_NOT_FOUND`. - [Send a message](https://help.onlyx.ai/developers/api-reference/messages/send-a-message.md): Sends a message to the fan on OnlyFans: text, free vault media (`previewMediaIds`), or a paid message (`mediaIds` locked behind `priceCents`, optionally with free teasers). **This reaches a real fan and cannot be taken back through the API**: when an automation or an AI assistant composes it, show a… - [List open hand-offs](https://help.onlyx.ai/developers/api-reference/hand-offs/list-open-hand-offs.md): Lists the open hand-offs, oldest first: conversations where the AI chatter decided a person should take over (a fan in distress, a refund demand, a request to meet, something it must not handle), and the few OnlyX raises itself when paid content did not arrive. The AI is silent in these chats and th… - [Resolve a hand-off](https://help.onlyx.ai/developers/api-reference/hand-offs/resolve-a-hand-off.md): Closes the open hand-off on this conversation, with an optional note saying what your team did. **This can reach the fan**: if the chat is still in `handoff` (nobody replied or took it over), it returns to the AI at once and the AI may answer the fan's waiting message within seconds. If your team al… - [List fans](https://help.onlyx.ai/developers/api-reference/fans/list-fans.md): Lists fans across every creator the credential can see, or one creator's with `creatorId`. Segments give you ready-made groups: `whales` ($200 or more spent), `spenders`, `never_spent`, `new` (subscribed in the last 7 days), `recent_buyer` (bought in the last 30 days), `lapsing` (auto-renew off, sub… - [Get a fan](https://help.onlyx.ai/developers/api-reference/fans/get-a-fan.md): Returns one fan: subscription, lifetime spend split into tips and paid messages, last activity, the creator's fan lists they are on, your team's custom name and notes, and `salesOptOut`. A fan belongs to one creator; the same person subscribed to two of your creators is two fans. A fan the credentia… - [Update a fan](https://help.onlyx.ai/developers/api-reference/fans/update-a-fan.md): Sets your team's own fields on a fan: a `customName`, free-text `notes`, and the `muted` flag. Send only the fields you want to change; an empty string or `null` clears a text field. These fields live only in OnlyX: nothing is sent to the fan, and muting never mutes or blocks anyone on OnlyFans. Any… - [List a fan's purchases](https://help.onlyx.ai/developers/api-reference/fans/list-a-fans-purchases.md): Returns what a fan has bought from the creator, newest first: paid-message unlocks (with the message id) and tips, each with the amount in cents. Sales the AI made, sales your team made and unlocks bought on OnlyFans directly are all included; refunded sales are not. Use it to see what a fan already… - [List fan lists](https://help.onlyx.ai/developers/api-reference/fans/list-fan-lists.md): Lists the creators' OnlyFans fan lists — system lists such as all subscribers or renew-off, and lists the creator made herself — with how many fans are on each. List ids appear on each fan's `lists`. Lists are mirrored from OnlyFans; managing them is not available through the API yet. A `creatorId`… - [List vault media](https://help.onlyx.ai/developers/api-reference/media/list-vault-media.md): Lists the creator's OnlyFans vault: photos, videos, GIFs and audio with size, length, the vault lists they are in and how they performed. The ids are what you use in messages (`mediaIds`, `previewMediaIds`), in the welcome message and on AI content levels. The list is OnlyX's stored copy of her vaul… - [Get a thumbnail](https://help.onlyx.ai/developers/api-reference/media/get-a-thumbnail.md): Returns a small preview image of one vault item as image bytes, not JSON. Only small previews are served: full-size originals and videos are not available through the API. The call needs your credential, so a browser cannot load `thumbnailUrl` directly in an `` tag: fetch it on your server. Res… - [Get today's numbers](https://help.onlyx.ai/developers/api-reference/stats/get-todays-numbers.md): Returns today so far, from local midnight in the workspace time zone: earnings (settled and still clearing), new fans, buyers, paid messages unlocked, message volume and how much of it the AI wrote — with yesterday up to the same time of day and all of yesterday for comparison. Covers every creator… - [Get revenue](https://help.onlyx.ai/developers/api-reference/stats/get-revenue.md): Returns earnings for a window: totals (net after OnlyFans' fee, gross, fee, settled versus still clearing, refunds), a split by what was paid for, one entry per day, per creator, and paid-message sales by who sent them — the AI (`ai`) or your team (`team`). Choose the window with `days`, or with `st… - [Get the audience](https://help.onlyx.ai/developers/api-reference/stats/get-the-audience.md): Summarises the fans: how many are active, expired or not yet reported by OnlyFans, auto-renew among active fans, how they spread over lifetime-spend bands, how many wrote in the last 7, 30 and 90 days, and week-over-week retention of fans who write. Covers every creator the credential can see, or on… - [Get the overview report](https://help.onlyx.ai/developers/api-reference/stats/get-the-overview-report.md): Returns the dashboard's activity report for a window: active and answered conversations, messages in and out, how many the AI and your team wrote, reply times, new fans, the inbox right now, and daily, hourly and per-creator breakdowns. It is expensive, so it is never computed while you wait: if a c… - [List a creator's transactions](https://help.onlyx.ai/developers/api-reference/stats/list-a-creators-transactions.md): Returns one creator's earnings ledger, newest first: every subscription, paid message, tip and other sale with what the fan paid (`amountCents`), what she receives after the platform's fee (`netCents`), who paid and whether the money is settled or still clearing. The ledger is the copy OnlyX keeps w… - [Get the AI persona](https://help.onlyx.ai/developers/api-reference/ai-persona/get-the-ai-persona.md): Returns the creator's AI persona: the brief your team wrote so the AI chatter can chat as her (name, age, city, backstory, voice, boundaries, hard limits, sample messages, custom-content prices, and which situations hand off to your team). It also reports `completeness`, `readyForAi` and `requiredMi… - [Update the AI persona](https://help.onlyx.ai/developers/api-reference/ai-persona/update-the-ai-persona.md): Changes the AI persona. It is a true PATCH: fields you leave out stay as they are, `null` clears a field, and a field name that is not part of the persona is refused with `400 VALIDATION_ERROR`. Lists (`boundaries`, `hardLimits`, `exemplars`, …) are replaced whole, `timezone` must be a valid IANA zo… - [Get the AI content board](https://help.onlyx.ai/developers/api-reference/ai-content/get-the-ai-content-board.md): Returns everything the AI chatter can sell for this creator: folders, ladders (collections), their priced levels (sets) with preview and paid media, and how much of the vault is used. Each level's `stats` are AI-attributed: they count what the AI chatter offered and sold, not your team's sales. Read… - [Create a folder](https://help.onlyx.ai/developers/api-reference/ai-content/create-a-folder.md): Creates a folder to organize ladders on the board. Folders are only for people; the AI ignores them. Returns the whole updated content board; find the new folder in `folders`. Answers `201` with the whole board. Nothing is sent to fans: the AI uses active ladders in its own conversations. AI content… - [Rename a folder](https://help.onlyx.ai/developers/api-reference/ai-content/rename-a-folder.md): Renames a folder. Returns the whole updated content board. Nothing is sent to fans: the AI uses active ladders in its own conversations. AI content writes are limited to 60 a minute per credential. - [Delete a folder](https://help.onlyx.ai/developers/api-reference/ai-content/delete-a-folder.md): Deletes a folder. Its ladders are kept and simply become unfiled; nothing the AI sells changes. Returns the whole updated content board. Nothing is sent to fans: the AI uses active ladders in its own conversations. AI content writes are limited to 60 a minute per credential. - [Create a ladder](https://help.onlyx.ai/developers/api-reference/ai-content/create-a-ladder.md): Creates a ladder (collection): a themed series of levels the AI sells in order (`sequential`, the default) or whenever they fit (`standard`). Create it with `active: false`, add its levels and media, verify, then switch it on, so the AI never offers a half-built ladder. `folderId` must be a folder o… - [Update a ladder](https://help.onlyx.ai/developers/api-reference/ai-content/update-a-ladder.md): Changes a ladder's name, folder, mode, description or `active` switch; send only what changes. `active: true` puts a finished ladder in front of the AI and `active: false` pauses all its levels at once. `folderId: null` takes it out of its folder. Returns the whole updated content board. Nothing is… - [Delete a ladder](https://help.onlyx.ai/developers/api-reference/ai-content/delete-a-ladder.md): Deletes a ladder together with all its levels and their media placements. The media stays in her vault. The AI stops offering it at once; to stop selling it temporarily, set `active: false` instead. Returns the whole updated content board. Nothing is sent to fans: the AI uses active ladders in its o… - [Reorder a ladder's levels](https://help.onlyx.ai/developers/api-reference/ai-content/reorder-a-ladders-levels.md): Sets the order of a ladder's levels. In a sequential ladder this is the climb every fan follows: the AI always offers a fan the first level they have not bought. Levels you list come first, in your order; any you leave out keep their order after them, and an id that is not a level of this ladder is… - [Create a level](https://help.onlyx.ai/developers/api-reference/ai-content/create-a-level.md): Adds a level (set) at the end of a ladder. `priceCents` is required: it is the floor price the AI may sell above but never below, and `0` makes a free level whose media is given away to every fan who reaches it (right for an opener or a thank-you, expensive by mistake). Every field you send is appli… - [Update a level](https://help.onlyx.ai/developers/api-reference/ai-content/update-a-level.md): Changes a level; send only what changes. Changing `priceCents` between 0 and a price converts its media: free makes everything preview, priced makes everything paid (add the teaser back as preview afterwards). `active: false` pauses the level and `availableInPaidMessages: false` keeps it on the boar… - [Delete a level](https://help.onlyx.ai/developers/api-reference/ai-content/delete-a-level.md): Deletes a level and renumbers the levels after it. Its media stays in her vault, unplaced. Returns the whole updated content board. Nothing is sent to fans: the AI uses active ladders in its own conversations. AI content writes are limited to 60 a minute per credential. - [Add media to a level](https://help.onlyx.ai/developers/api-reference/ai-content/add-media-to-a-level.md): Places vault media on a level as `paid` (locked behind the price) or `preview` (the free teaser that sells it). A media item can be on only one level, so adding it here moves it from any other level. On a free level everything is stored as preview. A priced level needs at least one paid item before… - [Remove media from a level](https://help.onlyx.ai/developers/api-reference/ai-content/remove-media-from-a-level.md): Takes one media item off a level; the item stays in her vault. A level that is not hers, or media that is not on that level, is a `404`. Returns the whole updated content board. Nothing is sent to fans: the AI uses active ladders in its own conversations. AI content writes are limited to 60 a minute… - [Reorder a level's media](https://help.onlyx.ai/developers/api-reference/ai-content/reorder-a-levels-media.md): Sets the order of one side of a level: `preview` is the order fans see the teasers, `paid` the unlock order. List the media ids of that side in the order you want; any you leave out follow them in their current order, and an id that is not on that side of the level is a `400`. Returns the whole upda… - [Get AI settings](https://help.onlyx.ai/developers/api-reference/ai-settings/get-ai-settings.md): Returns how the AI chatter behaves for this creator: the master AI switch, follow-ups to fans who went quiet (the setting, whether they actually go out, today's counts), review mode (whether every AI reply waits for a person, and how many are waiting now), and the AI's scheduled messages to fan list… - [Update AI settings](https://help.onlyx.ai/developers/api-reference/ai-settings/update-ai-settings.md): Changes the AI switch, follow-ups or review mode; send only what changes. These settings reach real fans: `aiEnabled: true` lets the AI answer every waiting fan, follow-ups are real messages, and **turning review mode off releases every waiting draft to fans immediately** — except drafts that have w… - [Get the welcome message](https://help.onlyx.ai/developers/api-reference/ai-settings/get-the-welcome-message.md): Returns OnlyFans' automatic welcome message for this creator, the message every new subscriber receives: whether it is on, its text, price and media, whether a change you made is still being applied (`pending`), and how your latest change went (`lastUpdate`). When she is not connected, `connected` i… - [Replace the welcome message](https://help.onlyx.ai/developers/api-reference/ai-settings/replace-the-welcome-message.md): Replaces the welcome message on her live OnlyFans account. This rewrites what every NEW subscriber receives and pays from now on, so confirm the exact text, media and price with a person first. The change is applied on OnlyFans in the background: the answer is `202` and `GET …/welcome-message` shows… - [List tracking links](https://help.onlyx.ai/developers/api-reference/tracking-links/list-tracking-links.md): Lists the creator's OnlyFans tracking and trial links, most clicks first, with clicks and subscribers from OnlyFans, your cost fields, and computed earnings, profit, ROI and per-click and per-fan figures (all money in cents; a figure that cannot be worked out is `null`, never `0`). OnlyX reads the l… - [Get a tracking link](https://help.onlyx.ai/developers/api-reference/tracking-links/get-a-tracking-link.md): Returns one tracking link with its daily history: cumulative clicks and subscribers at the end of each day OnlyX read it, and what each day added. `days` sets the window, 1 to 365 (default 90). A link that belongs to another creator is `404 NOT_FOUND`, even in your own workspace. - [Update a tracking link](https://help.onlyx.ai/developers/api-reference/tracking-links/update-a-tracking-link.md): Records what a promotion cost and where it ran, adds a note, or archives the link in OnlyX. Send only what changes; `null` clears `costCents`, `source` or `note`. Cost drives the computed profit, ROI, cost per click and cost per fan. These fields live only in OnlyX: nothing changes on OnlyFans, and… - [Create a tracking link](https://help.onlyx.ai/developers/api-reference/tracking-links/create-a-tracking-link.md): Creates a REAL tracking or free-trial link on the creator's live OnlyFans account; it cannot be deleted through the API, so confirm the name (and, for a trial, the length, claim limit and expiry) with a person first. An `Idempotency-Key` header is required, and a retry with the same key never create… - [Get a tracking link creation](https://help.onlyx.ai/developers/api-reference/tracking-links/get-a-tracking-link-creation.md): Returns the progress of a tracking-link creation started with `POST …/tracking-links`. Poll every 5 seconds or more. `completed` carries the new link's `url` as soon as OnlyFans shows it; `linkId` can stay `null` until OnlyX next reads her links (up to about an hour). `failed` carries an `error` wit… ## OpenAPI Specs - [openapi](/developers/api-reference/openapi.json) ## Optional - [Contact support](mailto:support@onlyx.ai)