> ## Documentation Index
> Fetch the complete documentation index at: https://help.onlyx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## 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 <API key>`; 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.

# What is OnlyX?

> OnlyX runs your creators' fan conversations with Hugo, the AI chatter. Learn what it does, who answers fans, and what you pay.

<Badge color="gray">Everyone</Badge>

OnlyX is where your agency runs the fan conversations of all your creators. Hugo, the AI chatter, answers the fans for you.

## What OnlyX does

| Part of OnlyX | What it does for you |
| - | - |
| **Master Inbox** | Shows the fan conversations of all your creators in one list. Your creators can be on OnlyFans or on Telegram. |
| Hugo | Answers fans in the creator's voice, day and night. He also sells her paid content in the conversation. |
| **Creators** | Gives each creator a page: her account connection, what Hugo knows about her, and what he may sell. |
| **Dashboard** and **Analytics** | Show today's earnings, the work that needs a person, and reports on fans, sales and chat activity. |
| **Members** | Lists your team. Each person has a role that decides what they can see. |

Owners, admins and chatters can open a conversation and answer the fan themselves at any time. Chatters see only the creators assigned to them, and content VAs do not see the inbox.

<Frame caption="**1** The conversations of all your creators · **2** Who answers this fan now · **3** What you know about the fan">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/A_JNh5CMtmyRxyYK/images/help/getting-started/what-is-onlyx/inbox-tour-light.png?fit=max&auto=format&n=A_JNh5CMtmyRxyYK&q=85&s=e0257a486eb353dc081d95b01e7f2286" alt="The Master Inbox with the conversation list, an open conversation that Hugo holds, and the fan panel with the fan's spend and subscription" width="1600" height="1304" data-path="images/help/getting-started/what-is-onlyx/inbox-tour-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/A_JNh5CMtmyRxyYK/images/help/getting-started/what-is-onlyx/inbox-tour-dark.png?fit=max&auto=format&n=A_JNh5CMtmyRxyYK&q=85&s=6680a4ff36ae2c3bfde1946171025c19" alt="The Master Inbox with the conversation list, an open conversation that Hugo holds, and the fan panel with the fan's spend and subscription" width="1600" height="1304" data-path="images/help/getting-started/what-is-onlyx/inbox-tour-dark.png" />
</Frame>

## Who answers each fan

Every conversation shows who holds it:

| State | Who answers the fan |
| - | - |
| **Hugo** | Hugo. |
| **Manual** | A person on your team. When someone replies or claims the conversation, Hugo stays out for 12 hours. |
| **Escalated** | A person. Hugo gave the conversation to your team and said why. |
| **Hugo off** | A person, always. Hugo never answers this fan. |

The app sums up the rule as "A human takes the thread whenever he stops". When Hugo should not handle something alone, the conversation waits in the Master Inbox with his reason. To learn more, see [Conversation states: Hugo, Manual, Escalated and Hugo off](/inbox/conversation-states).

## What Hugo needs before he answers

Each creator has her own **Hugo** switch. The app says it plainly: "The switch is permission, not a start button". Hugo answers a creator's fans only when all of these are true:

* Her account is connected.
* Her persona has an age and a backstory.
* Her hard limits are saved.
* At least one fan has synced from her account.

Hugo sells only the content that you map in **AI Content**. Without it, he still answers her fans, but he has nothing to sell.

A checklist on the creator's **Overview** tab shows which steps are done. When every step is done, its heading reads "Hugo is answering". When the switch is off, the heading reads "Hugo is off": nothing is sent, and every conversation waits for your team.

<Frame caption="**1** Where the creator stands · **2** Her Hugo switch · **3** The tab where you map what Hugo may sell">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/GlSdjgQ4YW5Ux4-e/images/help/getting-started/what-is-onlyx/creator-overview-light.png?fit=max&auto=format&n=GlSdjgQ4YW5Ux4-e&q=85&s=e229a17ba3eeae3fe5b4b29854c91b3e" alt="A creator's Overview tab with the heading Hugo is answering, the Hugo switch turned on, and the AI Content tab in the tab list" width="1600" height="1067" data-path="images/help/getting-started/what-is-onlyx/creator-overview-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/GlSdjgQ4YW5Ux4-e/images/help/getting-started/what-is-onlyx/creator-overview-dark.png?fit=max&auto=format&n=GlSdjgQ4YW5Ux4-e&q=85&s=5eff2d239b813b2a6930e26e5a2b6041" alt="A creator's Overview tab with the heading Hugo is answering, the Hugo switch turned on, and the AI Content tab in the tab list" width="1600" height="1067" data-path="images/help/getting-started/what-is-onlyx/creator-overview-dark.png" />
</Frame>

## What you pay

The inbox, your team and Hugo's chatting cost nothing. In the app's words, "Hugo works the inbox for free."

You pay only when Hugo sells. When a fan unlocks a <Tooltip tip="A pay-per-view message: the fan pays to unlock what is in it.">PPV</Tooltip> that Hugo sent, OnlyX takes 10% of the net:

* The net is what is left after OnlyFans takes its 20%. So 10% of the net is about 8% of what the fan paid.
* For example, a fan unlocks a $50 PPV from Hugo. OnlyFans takes $10, and $40 is left. You pay 10% of $40, which is \$4.
* For a Telegram creator, the payment fee on the sale takes the place of OnlyFans' 20%.

Everything else is free. The app lists it: "every message that does not sell, PPVs nobody opens, PPVs your own team sends by hand, tips and subscriptions". If a fan charges back a sale that Hugo made, email [support@onlyx.ai](mailto:support@onlyx.ai). OnlyX then returns its share to your balance.

OnlyX takes the charges from prepaid credits, once a day, shortly after midnight UTC. Every new workspace starts with \$10 of credits. You add more credits with USDT or USDC, from the **Billing** page. Only owners and admins can open **Billing**.

If your credits run out, Hugo keeps working through a grace period of up to 7 days. He pauses when the 7 days end, or sooner if you owe \$500 or more.

Then he stops answering and selling for all your creators until you add enough credits. Within the 7 days, that means enough to owe less than \$500. Once the 7 days have ended, it means enough to pay everything you owe.

Your team can still work in the inbox while Hugo is paused. See [Add credits so Hugo can sell](/getting-started/add-credits).

<Frame caption="Only the last step, when a fan buys, costs you anything.">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/GlSdjgQ4YW5Ux4-e/images/help/getting-started/what-is-onlyx/how-billing-works-light.png?fit=max&auto=format&n=GlSdjgQ4YW5Ux4-e&q=85&s=d9f0c791165616cd43423bd38a375770" alt="The How billing works card on the Billing page, with four steps and only the last one, You pay only if the fan buys, marked as charged" width="1600" height="713" data-path="images/help/getting-started/what-is-onlyx/how-billing-works-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/GlSdjgQ4YW5Ux4-e/images/help/getting-started/what-is-onlyx/how-billing-works-dark.png?fit=max&auto=format&n=GlSdjgQ4YW5Ux4-e&q=85&s=f35a64cb40811692846a1f69b7406ef5" alt="The How billing works card on the Billing page, with four steps and only the last one, You pay only if the fan buys, marked as charged" width="1600" height="713" data-path="images/help/getting-started/what-is-onlyx/how-billing-works-dark.png" />
</Frame>

## Who can do what

Each team member has one role in your workspace:

| Role | What they do |
| - | - |
| **Owner** | Created the workspace. Can do everything. |
| **Admin** | Runs the workspace: creators, inbox, fans, analytics, members and invites. |
| **Chatter** | Answers fans in the inbox, only for the creators assigned to them. |
| **Content VA** | Sets up **AI Persona** and **AI Content** for the creators assigned to them. Never sees the fan inbox. |

To learn more, see [What each team role can see and do](/team/roles-and-permissions).

## Get started

Owners set up a new workspace in this order:

1. [Create your agency account](/getting-started/create-your-account), then [Confirm your email](/getting-started/confirm-your-email).
2. [Add your first creator](/getting-started/add-your-first-creator) and connect her account.
3. Finish her setup with [Quick start: from sign-up to Hugo answering](/getting-started/quick-start).
4. [Add credits so Hugo can sell](/getting-started/add-credits).
5. [Invite your team](/getting-started/invite-your-team).

New to the screens? See [Find your way around OnlyX](/getting-started/find-your-way-around).

## What's next

<Columns cols={2}>
  <Card title="Quick start: from sign-up to Hugo answering" icon="rocket" href="/getting-started/quick-start" horizontal />

  <Card title="How Hugo works" icon="sparkles" href="/hugo/how-hugo-works" horizontal />

  <Card title="How billing works" icon="wallet" href="/billing/how-billing-works" horizontal />
</Columns>