---
title: "AI credits and automatic top-ups"
description: "Buy AI credits, top them up automatically when they run low, and see where they are spent."
canonical: "https://undocsend.com/docs/billing/ai-credits-and-auto-top-up"
last_updated: "2026-11-19"
---

# AI credits and automatic top-ups

Buy AI credits, top them up automatically when they run low, and see where they are spent.

## How credits work

- $1 buys 1,000 credits.
- Each AI request uses credits at the AI provider’s list price plus 15%. A typical agent answer uses about 5 to 30 credits, depending on its length and the model.
- Credits never expire while your workspace is active.
- New workspaces get 2,000 credits for the trial. Plans don’t include monthly credits; you buy what you use.

Credits pay for the AI agent’s answers and the other AI features in your workspace.

## Check your balance

Go to **Agent** in the sidebar. The top of the page shows your **Credit balance**, in dollars and in credits, and whether **Auto top-up** is on, off or paused. Owners and admins can open this page.

## Buy credits

1. On the **Agent** page, click **Buy credits**.
2. In **Add AI credits**, pick $20, $50 or $100, or type any whole-dollar **Amount (USD)** from $5 to $5,000. The dialog shows how many credits you’ll get.
3. Click **Pay** and complete the secure checkout.

You come back to the Agent page and the credits are added to your balance.

## Automatic top-ups

Automatic top-ups buy more credits when your balance runs low, so the agent never stops mid-conversation. They are off until you turn them on.

1. On the **Agent** page, click **Set up** next to Auto top-up (or **Manage** if it is already set up). This opens **Automatic top-ups**.
2. Under **Payment methods**, click **Add a payment method** and add a card, or choose a card you already added. The chosen card is marked **Used for automatic top-ups**.
3. Under **Automatic top-up settings**, tick **Enable automatic top-ups** and fill in the three fields below.
4. Click **Save settings**.

- **Top up when balance drops below**: The balance that triggers a top-up. Enter it in dollars or in credits.
- **Top-up amount**: How much to buy each time: any whole-dollar amount from $5 to $5,000.
- **Max top-ups per month**: A safety limit on how many automatic charges can happen in a month, from 1 to 31.

### When top-ups pause

Automatic top-ups pause themselves, and the page explains why, when:

- a charge is declined,
- your bank asks to confirm a payment, which needs you present, or
- there is an unusual burst of charges in a short time.

You also get an email if a charge fails. To resume, add or choose a card and turn top-ups back on. To remove a card, click **Remove card** next to it.

## Running low

When your balance falls below $1 (1,000 credits), the dashboard shows **AI credits running low** with a **Manage credits** button, and we email you. When credits run out, the agent stops answering unless your own AI key can take over.

## See where credits go

**Settings → Usage** shows your AI spend for the current billing cycle. Switch between **Dollars** and **Credits**, and see the spend **By room** and **By feature**. Spend not tied to a room is listed as **Workspace-level**. The page is read-only; it doesn’t set limits.

## Using your own AI key

You can connect your own key from a supported AI provider instead. undocsend adds no markup; you pay the provider directly. If your key fails partway through an answer, the answer is finished on credits, so using your own key needs at least $5 of credits or automatic top-ups turned on.

> Setting up the agent and your own key is covered in [AI](https://undocsend.com/docs/ai).

---

Section: Plans and billing. HTML: https://undocsend.com/docs/billing/ai-credits-and-auto-top-up · Docs index: https://undocsend.com/docs.md
