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

# Low balance, grace period and "Hugo is paused"

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

<Badge color="orange">Owners and admins</Badge>

Learn what each billing state means, and how to keep Hugo working when your balance runs out.

## The four states

The status card on the **Overview** tab always shows one of four states. The chip at the top of the page says the same in short.

| Status card | Chip at the top | What it means | What to do |
| - | - | - | - |
| **All good** | **Active** | Your **Net balance** is \$25 or more. | Nothing. |
| **Running low** | **Active** | Your **Net balance** is under \$25. | Add credits soon. |
| **Grace period** | **Grace — 4d left** (the days left) | Your credits went below zero. Hugo keeps working for a limited time. | Add at least what you owe. |
| **Hugo is paused** | **AI paused** | The grace period ended, or your debt reached \$500. Hugo does not answer fans. | Add the amount the card names. |

The status card has no button of its own. **Add credits** is on the **Balance** card, under the status card.

<Frame caption="**1** The status card · **2** The Net balance it watches · **3** Add credits">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/status-low-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=453d136b869e367f24024c139ae06972" alt="The status card showing Running low, with the Net balance on the Balance card under it and the Add credits button" width="1600" height="541" data-path="images/help/billing/low-balance-and-pause/status-low-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/status-low-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=66091085ba7a6b8c52700d270f7c8120" alt="The status card showing Running low, with the Net balance on the Balance card under it and the Add credits button" width="1600" height="541" data-path="images/help/billing/low-balance-and-pause/status-low-dark.png" />
</Frame>

## Running low

The card shows **Running low** when your **Net balance** is under $25. For example: "Hugo is selling, but only $14.80 is left". Nothing stops yet.

A new workspace shows **Running low** from its first day. It starts with $10 of **Welcome credits**, which is under the $25 line. This is expected.

## The grace period

The grace period starts when the daily charge takes your credits below zero. The charge runs a few minutes after midnight UTC. Before that charge, your **Net balance** can already be below zero while the card still shows **Running low**.

During the grace period, Hugo keeps working, and new sales still add fees. The card shows two clocks:

* **Grace period**: how many of the 7 days are left, for example "4 of 7 days left".
* **Debt limit**: how much you owe, out of $500, for example "$42.30 of \$500".

Hugo pauses when either clock runs out, whichever comes first. On the last day, the chip reads **Grace — 1d left**.

The $500 limit has no grace. If one daily charge takes your debt to $500 or more, Hugo pauses at once.

<Frame caption="**1** The two clocks: the days left, and your debt out of $500">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/status-grace-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=6e5b210c092a61b5b019132a7a5a83ec" alt="The Grace period status card saying you owe $42.30, with the Grace period clock at 4 of 7 days left and the Debt limit clock at $42.30 of $500" width="1600" height="352" data-path="images/help/billing/low-balance-and-pause/status-grace-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/status-grace-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=1b972da5f4e0d8c97201b7579062a9a0" alt="The Grace period status card saying you owe $42.30, with the Grace period clock at 4 of 7 days left and the Debt limit clock at $42.30 of $500" width="1600" height="352" data-path="images/help/billing/low-balance-and-pause/status-grace-dark.png" />
</Frame>

## When Hugo is paused

Hugo pauses when your debt is more than 7 days old, or when it reaches \$500. The card then says "Hugo has stopped selling", and the chip says **AI paused**.

The pause is wider than the card's words. While Hugo is paused:

* Hugo does not answer fans at all, for every creator in the workspace. He sends no replies, no follow-ups and no PPVs.
* Messages that fans send during the pause are not queued for Hugo.
* Hugo's messages that were waiting to go out are cancelled.
* If a fan unlocks a PPV that Hugo sent before the pause, the fee is still added. So your debt can still grow.

Your team keeps working. The inbox, your fans and your data are not affected, and your team can answer fans by hand.

<Warning>
  While Hugo is paused, fans get no answer unless your team replies by hand.
</Warning>

<Frame caption="**1** Why Hugo paused and how much to add · **2** Your credits show the debt · **3** Add credits">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/status-paused-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=99716fe2cf570ba0d128cce41f062132" alt="The Hugo is paused status card saying the $500 debt limit was reached and how much to add, Credits at minus $512.50, and the Add credits button" width="1600" height="563" data-path="images/help/billing/low-balance-and-pause/status-paused-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/status-paused-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=85476e60f873fa3bfe1c076e68af428c" alt="The Hugo is paused status card saying the $500 debt limit was reached and how much to add, Credits at minus $512.50, and the Add credits button" width="1600" height="563" data-path="images/help/billing/low-balance-and-pause/status-paused-dark.png" />
</Frame>

## What your team sees in the inbox

In each conversation that Hugo owns, your team sees "Hugo will not answer this thread" with the reason "Billing has stopped Hugo selling".

The **Open billing** button there opens **Billing**, but only for owners and admins. A chatter should answer the fan by hand and tell an owner or admin.

<Frame caption="**1** The reason: billing · **2** Open billing">
  <img className="block dark:hidden" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/inbox-billing-banner-light.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=6c6640ec65d03249eda7878e6a092204" alt="The notice Hugo will not answer this thread with the reason Billing has stopped Hugo selling, the Open billing button, and the message box under it" width="1440" height="672" data-path="images/help/billing/low-balance-and-pause/inbox-billing-banner-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/onlyx/wmKGwkhMJqCuthn-/images/help/billing/low-balance-and-pause/inbox-billing-banner-dark.png?fit=max&auto=format&n=wmKGwkhMJqCuthn-&q=85&s=edad57da321193c2ed408091f57d4a24" alt="The notice Hugo will not answer this thread with the reason Billing has stopped Hugo selling, the Open billing button, and the message box under it" width="1440" height="672" data-path="images/help/billing/low-balance-and-pause/inbox-billing-banner-dark.png" />
</Frame>

## Get Hugo working again

<Steps>
  <Step title="Open the Billing page">
    In OnlyX, click **Billing**.

    The status card is at the top of the **Overview** tab.
  </Step>

  <Step title="Read how much to add">
    Read the status card. It names the amount you need.

    If the debt reached $500, it says how much gets you back under the limit, for example "Add at least $12.51". If the 7 days ran out, it says how much you owe, for example "Clear the \$42.30 owed".

    Once the debt is more than 7 days old, only paying everything you owe brings Hugo back.
  </Step>

  <Step title="Add credits">
    On the **Balance** card, click **Add credits**. Then make a deposit of at least that amount, and at least 50 USDT or USDC. Only the coins that arrive count. The steps are in [Add credits with USDT or USDC](/billing/add-credits).
  </Step>

  <Step title="Reload the page">
    When the credit lands, reload the page.

    The status card and the chip show the new state.
  </Step>
</Steps>

When Hugo comes back depends on why he paused:

| Why Hugo paused | What to add | When Hugo is back |
| - | - | - |
| Your debt reached \$500. | More than the amount over $500. The card names the smallest amount that works, for example "Add at least $12.51" on a \$512.50 debt. The smallest deposit is 50 USDT or USDC. | Within about 5 minutes, but only if the debt is not yet more than 7 days old. You are then back in the grace period, and its 7 days still count from when the debt began. |
| The 7 days ran out. | Everything you owe. A smaller payment does not bring Hugo back. | As soon as the credit lands. |
| Either reason | Enough to bring your credits to \$0 or more. | As soon as the credit lands. The grace period ends too. |

When Hugo is back, he may still answer fans who wrote during the pause. This works if the fan's last message is no more than 7 days old. Answer older or urgent messages yourself.

## If something goes wrong

<AccordionGroup>
  <Accordion title="I added credits, but the card still shows Grace period or Hugo is paused">
    To leave the grace period, your **Credits** must reach \$0 or more. A smaller deposit only lowers what you owe, so the card stays on **Grace period**.

    The page does not update by itself: reload it. A deposit that shows **Confirming on-chain** does not count until it lands.

    After a pause at the $500 limit, Hugo comes back within about 5 minutes once you owe less than $500. Until then, the card still shows **Hugo is paused**, and it can say that the 7-day grace period ran out. Wait 5 minutes, then reload.

    This works only while the debt is 7 days old or less. Once the debt is older than that, you must pay everything you owe.
  </Accordion>

  <Accordion title="My new workspace says Running low">
    A new workspace starts with $10 of **Welcome credits**, which is under the $25 line. Add credits when you are ready.
  </Accordion>

  <Accordion title="My Net balance is below zero, but the card still says Running low">
    The grace period starts only when the daily charge takes your credits below zero, a few minutes after midnight UTC. Add credits now to avoid it.
  </Accordion>

  <Accordion title="My team sees &#x22;Hugo will not answer this thread&#x22;">
    If the reason is "Billing has stopped Hugo selling", Hugo is paused for billing. An owner or admin must add credits. Until then, your team answers fans by hand.
  </Accordion>
</AccordionGroup>

## What's next

<Columns cols={2}>
  <Card title="Add credits with USDT or USDC" icon="coins" href="/billing/add-credits" horizontal />

  <Card title="Billing emails and alerts" icon="bell" href="/billing/billing-alerts" horizontal />

  <Card title={'"Hugo will not answer this thread"'} icon="message-circle-warning" href="/inbox/hugo-will-not-answer" horizontal />
</Columns>
