How Can I Top Up My Tokens

Overview

Tokens power AI-driven features in Breakcold — such as email enrichment, phone lookups, LinkedIn data, and AI Filter Generation. You can top up your token balance in two ways:

1. Manual purchase — buy a specific amount of tokens on demand.
2. Auto Top-Up — automatically refill your balance when it falls below a threshold.

To access token settings, navigate to Organization → Billing in the left sidebar.

The Billing page showing your current plan, resource limits, and Token Usage section.

Option 1 — Manually Buy Tokens

1. Use the Buy Tokens button to make a one-time token purchase and instantly add funds to your organization's balance.
2. Go to Organization → Billing in the sidebar.
3. Scroll down to the Token Usage section. You will see your Current Balance.
4. Click the Buy Tokens button on the right side of the Token Usage card.

The Token Usage section displays your current balance and the Buy Tokens button.

4. A Buy Tokens modal will open. You can either type a custom amount in the input field, or click one of the preset options: 10, 25, 50, or 100.

The Buy Tokens modal with preset options (10, 25, 50, 100) and a custom amount input.

5. The estimated cost updates live as you type or select a preset. Click Buy to confirm the purchase.

Example: selecting 50 tokens shows an estimated cost of $0.50 before confirming.

Option 2 — Enable Auto Top-Up

Auto Top-Up automatically purchases tokens whenever your balance drops below a defined threshold, so your team never runs out mid-workflow.

1. On the Billing page, scroll down to the Auto Top-Up section (just below Token Usage).
2. Toggle the switch from Disabled to Enabled.

Once enabled, three configuration fields appear: threshold, tokens to add, and monthly cap.

3. Configure the three settings:

• Top up when balance falls below — the token threshold that triggers an automatic purchase (e.g., 200).
• Tokens to add — how many tokens to purchase each time the threshold is hit (e.g., 1,000).
• Maximum top-ups per month — a spending cap to limit how many automatic purchases can occur per month (e.g., 3).

Example: trigger at 200 tokens remaining, add 1,000 tokens each time, capped at 3 top-ups per month.

4. Click Save Settings to apply your Auto Top-Up configuration.

Toggling the switch off and saving returns Auto Top-Up to the Disabled state.

Estimated Token Costs by Feature

The Billing page also displays a reference table of approximate token consumption per feature.

Frequently Asked Questions

Where do I find my current token balance?

Go to Organization → Billing. Your current balance is shown in the Token Usage section under Current Balance.

Can I set a monthly spending cap?

Yes. When configuring Auto Top-Up, the Maximum top-ups per month field limits how many automatic purchases can be triggered each calendar month.

What happens if my tokens run out?

AI-powered features (enrichment, AI filters, etc.) will stop working until your balance is replenished — either manually or via Auto Top-Up.

Is there a minimum purchase amount?

The minimum preset is 10 tokens ($0.10). You can also enter a custom amount in the Buy Tokens modal.

Can I disable Auto Top-Up at any time?

Yes. Simply toggle the Auto Top-Up switch to Disabled and click Save Settings.