> ## 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.

# Build your first collection

> 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.

<Badge color="purple">Owners, admins and content VAs</Badge>

Build a collection that Hugo can sell from: a name, a few priced levels, and vault files on each level.

## Before you start

* You need an owner, admin or content VA account. A content VA works only on the creators assigned to them. Chatters can open AI Content, but they cannot change it.
* Sync the creator's vault first, so her files are there to place. On the creator's page, click **Vault**. Then click **Sync vault**. For a Telegram creator, upload her files on the **Media** tab instead.
* Plan it first: one theme or one shoot, with 3 or 4 paid levels that each go a little further. [How AI Content works: groups, collections and levels](/ai-content/how-ai-content-works) explains the parts.

<Note>
  Changes on the board go live as soon as they are saved: there is no draft or publish step. Hugo can offer a new collection as soon as it holds a level he can sell. Pause the collection while you build it.
</Note>

## Create the collection

<Steps>
  <Step title="Open AI Content">
    In OnlyX, click **Creators**. Then click the creator's card.

    In the creator's menu, under **Hugo**, click **AI Content**. The board opens. An empty board says "Nothing for Hugo to sell yet".

    <Frame caption="**1** AI Content in the creator's menu · **2** New collection">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/open-ai-content-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=5339cb62b35d301afd702bcdf1ce5f19" alt="A creator's page with AI Content selected in her menu and the New collection button in the middle of an empty board" width="1600" height="869" data-path="images/help/ai-content/build-your-first-collection/open-ai-content-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/open-ai-content-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=2e8d0119330e8de01d31bb2941d1724e" alt="A creator's page with AI Content selected in her menu and the New collection button in the middle of an empty board" width="1600" height="869" data-path="images/help/ai-content/build-your-first-collection/open-ai-content-dark.png" />
    </Frame>
  </Step>

  <Step title="Start a new collection">
    Click **New collection**. On an empty board, the button is in the middle of the page. On a board with collections, it is at the end of the collection list.

    The **New collection** window opens.
  </Step>

  <Step title="Name the collection">
    In **Name · Hugo uses it when he talks about this**, enter the theme in one or two words, such as "Shower" or "Lingerie".

    Use the word your fans type. Hugo uses the name when he talks about the collection. A name such as "Set A" tells a fan nothing.
  </Step>

  <Step title="Optional: Choose a group">
    In **Group**, keep **No group**, or pick one of your groups. To make a new group, select **+ New group**. Then type its name in the box that appears.

    A group is only a heading in your collection list. Hugo never reads it.
  </Step>

  <Step title="Choose how Hugo walks it">
    Under **How Hugo walks it**, keep **Story · levels in order** for one shoot that goes further level by level. Choose **Menu · any level that fits** for a theme made of separate sets. To compare the two, see [Story or Menu: choose how Hugo walks a collection](/ai-content/story-vs-menu).

    <Frame caption="**1** The name Hugo uses · **2** The group, a heading Hugo never reads · **3** How Hugo walks it">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/new-collection-dialog-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=08a01a315a1fe401aac2f69f6f800e17" alt="The New collection window filled in: a name, a new group, Story chosen as the way Hugo walks it, and a short About text" width="1600" height="1414" data-path="images/help/ai-content/build-your-first-collection/new-collection-dialog-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/new-collection-dialog-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=33827f1d1787c9614e0d02f2bc4fb941" alt="The New collection window filled in: a name, a new group, Story chosen as the way Hugo walks it, and a short About text" width="1600" height="1414" data-path="images/help/ai-content/build-your-first-collection/new-collection-dialog-dark.png" />
    </Frame>
  </Step>

  <Step title="Describe the collection">
    In **About · what this collection is**, write two or three plain sentences about what the whole collection shows.

    Hugo reads this to decide when the collection fits a fan. He also uses it for any level that has no About of its own. Describe only what is really in the files.
  </Step>

  <Step title="Create the collection">
    Click **Create collection**. The message "Collection created" appears, and your new collection opens. It says "No levels yet."
  </Step>
</Steps>

## Pause the collection while you build it

We recommend this step. A paused collection keeps everything, but Hugo does not offer it until you resume it.

<Steps>
  <Step title="Open the collection's menu">
    In the collection list, point to your new collection. Three dots (⋯) appear at the end of its row. Click them.
  </Step>

  <Step title="Pause the collection">
    Select **Pause collection**. The message "Collection paused · hidden from Hugo" appears. At the top of the ladder, a **Paused** badge shows next to the collection's name.

    <Frame caption="**1** Pause collection, in the menu of the collection">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/pause-collection-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=305247e2cae932cb63f735441b7d07ed" alt="The menu of a new collection in the collection list, open on Pause collection" width="1600" height="797" data-path="images/help/ai-content/build-your-first-collection/pause-collection-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/pause-collection-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=23b51faffb8507bc395699589567d783" alt="The menu of a new collection in the collection list, open on Pause collection" width="1600" height="797" data-path="images/help/ai-content/build-your-first-collection/pause-collection-dark.png" />
    </Frame>
  </Step>
</Steps>

On a phone, or in a narrow browser window, the collection list has no menu. Tap **Edit** at the top of the ladder. Then tap **Pause**.

## Add the levels

A level is one thing Hugo can offer. We recommend a free opener, then 3 or 4 paid levels. Each paid level shows a little more than the last, and costs a little more.

<Steps>
  <Step title="Optional: Add a free opener">
    At the top of the ladder, click **Add level**. Then select **Free level**.

    A free level appears as L1. The small word above its price reads **opener**, in capitals. Everything on a free level goes to the fan unlocked. It is never sold.

    <Frame caption="**1** Add level · **2** A paid level at its starting price · **3** A free level">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/add-level-menu-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=f4b4080d444f1e9af853f0765f19aabd" alt="An empty collection with the Add level menu open, offering Paid level at $5 and Free level" width="1440" height="440" data-path="images/help/ai-content/build-your-first-collection/add-level-menu-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/add-level-menu-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=a2547e7cf09f25ef5d3bdf44c8930d66" alt="An empty collection with the Add level menu open, offering Paid level at $5 and Free level" width="1440" height="440" data-path="images/help/ai-content/build-your-first-collection/add-level-menu-dark.png" />
    </Frame>
  </Step>

  <Step title="Rename the opener">
    The new free level is named "Aftercare", even when it comes first. Click that name. Type what the level shows. Then press <kbd>Enter</kbd>.
  </Step>

  <Step title="Add a paid level">
    Click **Add level**. Then select \*\*Paid level · $5**. The price on the button is $5 more than your last paid level, or \$5 for the first one.

    The new level appears at the end of the ladder. It shows **Unnamed level** and a red **Nothing behind the price** badge, because it has no paid files yet.
  </Step>

  <Step title="Set the price">
    Click the price on the level's row. Type the price floor for this level. Then press <kbd>Enter</kbd>.

    This price is a floor: Hugo never sells the whole level for less. He may ask more from a fan who has shown he pays well. See [Set price floors and tags](/ai-content/prices-and-tags).
  </Step>

  <Step title="Name the level">
    Click **Unnamed level**. Type one line that says what the level holds, such as "Red dress at sunset". Then press <kbd>Enter</kbd>.

    Hugo reads this name to know what the level is. It also helps him match the level to what a fan asks for. When he offers the level, he describes what the files show instead of saying the name. A level with no name reaches him only as the collection's name and a number, such as "Shower 2".

    <Frame caption="**1** The price · **2** The name · **3** Add paid, to put files on the level">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/level-row-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=bc6d9c5292cbaecd8bc31c037a210d54" alt="A ladder with a free opener and a new paid level at $5 that has no name yet, a red warning and an Add paid button" width="1440" height="628" data-path="images/help/ai-content/build-your-first-collection/level-row-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/level-row-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=aa2844e21db84ed44aa38089c0b4e8eb" alt="A ladder with a free opener and a new paid level at $5 that has no name yet, a red warning and an Add paid button" width="1440" height="628" data-path="images/help/ai-content/build-your-first-collection/level-row-dark.png" />
    </Frame>
  </Step>

  <Step title="Add the next levels">
    Repeat these steps for each paid level. Make each one go a little further than the one before.

    Keep to about four paid levels. The app's own advice is "Levels past the fourth have barely ever sold."
  </Step>
</Steps>

## Put files on each level

A paid level holds two kinds of file. The teaser is free: Hugo sends it first, so the fan wants the rest. The paid files sit behind the price.

We recommend one teaser and several paid files on each paid level. More paid files give Hugo more to offer.

<Steps>
  <Step title="Open the picker">
    On the level's row, click **Add paid**. On a level that already has paid files, the button reads **Add**.

    A window called "Add to L2" (with the level's number and name) opens. Its **Slot** is set to **Paid**.
  </Step>

  <Step title="Pick the paid files">
    Click each file you want. A check mark appears on it. To pick several files in a row, click the first one. Then hold <kbd>Shift</kbd> and click the last one.

    To find one shoot fast, use the filters at the top of the window. You can filter by file type or by vault list, and change the order. **Top earning** puts the files that already sell first.
  </Step>

  <Step title="Add them to the level">
    Click **Add 4 to Paid**. The number is how many files you picked.

    The window closes, and the files show on the level's row. The red badge changes to a yellow **No teaser** badge. Hugo can sell the level now, but without a teaser to show first.

    <Frame caption="**1** The slot: Teaser or Paid · **2** How many files you picked · **3** The button that adds them">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/picker-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=8b86b396c962714aa540f8194ea717b6" alt="The Add to L2 window set to the Paid slot, with four vault files ticked and the Add 4 to Paid button" width="1600" height="1483" data-path="images/help/ai-content/build-your-first-collection/picker-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/picker-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=46d120f72ec6087a0ee9f09f857debc1" alt="The Add to L2 window set to the Paid slot, with four vault files ticked and the Add 4 to Paid button" width="1600" height="1483" data-path="images/help/ai-content/build-your-first-collection/picker-dark.png" />
    </Frame>
  </Step>

  <Step title="Add a teaser">
    On the same row, click **Add** again. Next to **Slot**, click **Teaser · free**. Pick one file. Then click **Add 1 to Teaser**.

    The teaser shows on the row with a green "free" strip across it, and the **No teaser** badge goes away.
  </Step>

  <Step title="Check the row">
    A level with a teaser and paid files shows no badge at all. If a row shows a red or yellow badge, see [Fix "Nothing sellable yet" and other level warnings](/ai-content/level-states).
  </Step>
</Steps>

### On a computer: drag files from the vault

In a browser window at least 1,024 pixels wide, you can also drag files from the vault onto a level.

<Steps>
  <Step title="Open the vault">
    Click the **Vault** strip next to the ladder, or press <kbd>V</kbd>. The vault opens next to the ladder.
  </Step>

  <Step title="Select the files">
    Click the files you want. A check mark appears on each one.
  </Step>

  <Step title="Drag them onto a level">
    Drag the files onto a level's row. On a paid level, they go behind the price. To make them the teaser, drop them on the dashed teaser box that appears while you drag.

    To put them on a new paid level instead, click **New level from selection**.

    <Frame caption="**1** The vault · **2** New level from selection · **3** A level to drop the files on">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/drawer-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=40c55b986d9e3eb9e4b9ccc7615704ed" alt="The vault open next to the ladder with three files selected, the New level from selection button and a level row ready for the files" width="1600" height="1189" data-path="images/help/ai-content/build-your-first-collection/drawer-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/drawer-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=0f7cec509234a9eff98d48a09440f6d4" alt="The vault open next to the ladder with three files selected, the New level from selection button and a level row ready for the files" width="1600" height="1189" data-path="images/help/ai-content/build-your-first-collection/drawer-dark.png" />
    </Frame>
  </Step>
</Steps>

### On a phone

A phone, or a browser window narrower than 1,024 pixels, shows a simpler board. The collections are a row of buttons at the top. To start a collection, tap **Collection**, the button with the plus sign.

At the bottom of the screen, **Add level** adds a level, and **Vault** opens the picker. There is no drag and drop there.

<Frame caption="**1** Your collections · **2** Add level and Vault">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/phone-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=62691c600c2ba836868f60417efb8945" alt="AI Content on a phone: the collections as a row of buttons and the Add level and Vault buttons at the bottom of the screen" width="1600" height="1778" data-path="images/help/ai-content/build-your-first-collection/phone-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/phone-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=f0c341971d54669c9b4f8c102eaa53d9" alt="AI Content on a phone: the collections as a row of buttons and the Add level and Vault buttons at the bottom of the screen" width="1600" height="1778" data-path="images/help/ai-content/build-your-first-collection/phone-dark.png" />
</Frame>

## Check your work and resume the collection

<Steps>
  <Step title="Check every level">
    Look at each row of the collection. No row should show a red badge. Check that each price and each name is what you meant.
  </Step>

  <Step title="Resume the collection">
    In the collection list, point to the collection and click the three dots (⋯). Select **Resume collection**.

    The message "Collection resumed" appears. Hugo can now offer the collection's levels to fans.

    <Frame caption="**1** A level ready to sell: a teaser and paid files, no badge · **2** The Paused badge · **3** Resume collection">
      <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/resume-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=84ed82033651c649c3619348ecb60821" alt="A finished collection that is still paused, with its menu open on Resume collection and a level holding a teaser and paid files" width="1600" height="868" data-path="images/help/ai-content/build-your-first-collection/resume-light.png" />

      <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/ai-content/build-your-first-collection/resume-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=f9131becbb86480f267c901b82fa1373" alt="A finished collection that is still paused, with its menu open on Resume collection and a level holding a teaser and paid files" width="1600" height="868" data-path="images/help/ai-content/build-your-first-collection/resume-dark.png" />
    </Frame>
  </Step>
</Steps>

## If something goes wrong

<AccordionGroup>
  <Accordion title="A change shows &#x22;That did not save&#x22;">
    Your role cannot change AI Content, or you are a content VA and this creator is not assigned to you. Ask an owner or admin to check your role and your creators in **Settings** > **Members**. If your role is right, reload the page and try again.
  </Accordion>

  <Accordion title="The picker says &#x22;Nothing here. Sync the vault on the Vault tab first.&#x22;">
    OnlyX has no files for this creator yet. Open her **Vault** tab and click **Sync vault**. The files arrive in a minute or two.

    If the Vault tab says the creator has no connected OnlyFans account, reconnect her first. For a Telegram creator, upload her files on the **Media** tab.
  </Accordion>

  <Accordion title="A file I know is in the vault is not in the picker">
    In the picker, **Hide placed** is ticked, so files that are already on a level are hidden. Untick it. A file that is on a level shows that level's number, such as L2.

    The picker also loads 200 files at a time. When the vault holds more, a button at the bottom of the window loads the next ones, such as **Load 200 more**.
  </Accordion>

  <Accordion title="&#x22;2 files moved from another level&#x22;, and another level turned red">
    A file can be on only one level. When you add a file that is already on a level, OnlyX moves it, so its old level loses it. Put another file on that level.
  </Accordion>

  <Accordion title="The first level is called &#x22;Aftercare&#x22;">
    **Free level** always names the new level "Aftercare". When the level comes first, it works as the opener anyway. Click the name and rename it.
  </Accordion>

  <Accordion title="Create collection stays grey">
    The collection has no name yet. If you chose **+ New group**, the new group needs a name too.
  </Accordion>
</AccordionGroup>

## What's next

<Columns cols={2}>
  <Card title="Levels: teasers, paid pieces, openers and aftercare" icon="layers" href="/ai-content/levels" horizontal />

  <Card title="Set price floors and tags" icon="tag" href="/ai-content/prices-and-tags" horizontal />

  <Card title="Fix &#x22;Nothing sellable yet&#x22; and other level warnings" icon="triangle-alert" href="/ai-content/level-states" horizontal />
</Columns>
