Articles on: Organization

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.


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

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


Note — Token checkout is currently being migrated to Stripe. The Buy Tokens dialog lets you preview token pack pricing while the final purchase flow is being connected.Pricing: Tokens are priced at $0.01 per token — that's $1.00 per 100 tokens. The estimated cost is displayed in real time inside the modal.

Preset

Tokens

Estimated Cost

10

10

$0.10

25

25

$0.25

50

50

$0.50

100

100

$1.00

Custom

Any amount

Calculated at $0.01 / token

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.


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


  1. Click Save Settings to apply your Auto Top-Up configuration.
Tip: Set your "Tokens to add" high enough to cover peak usage periods. You can always adjust the settings or disable Auto Top-Up at any time by toggling the switch off and clicking Save Settings.


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.

Feature / Data Point

Approximate Token Cost

Email enrichment

10 tokens

Personal Email enrichment

40 tokens

Phone enrichment

80 tokens

LinkedIn enrichment

10 tokens

Person Metadata

0 tokens (free)

Company Metadata

0 tokens (free)

AI Filter Generation

~0.2–1.5 tokens

Note: Actual token consumption may vary based on data complexity, record volume, and the specific operations performed. Costs shown are approximations. See "What are Tokens Used For?" for the full feature breakdown.

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.

Updated on: 10/08/2026