What are Stars
Stars (★) are Apollo Space’s internal currency. Every billable action — a public search, an outbound email, a WhatsApp message, an external tool execution — draws Stars from your organization’s wallet. Instead of reconciling the heterogeneous costs of each vendor (LLM tokens, Twilio per-country cents, Tavily per call), Apollo Space gives you a single unit to track all platform usage.The wallet has two compartments
- Monthly (renews every month)
- Package (rollover, never expires)
Recurring subscription credit
Included in your subscription plan. Renews automatically
every month alongside your plan billing cycle.
Deduction order: when a billable call is made, Apollo Space debits
the Monthly balance first (because it expires) and only then the
Package balance. You can see each compartment’s balance separately
under the Billing tab in your org settings.
Where Stars are spent
Every time an agent triggers a capability with an underlying cost:| Category | Examples |
|---|---|
| LLM | Language model tokens — every agent conversation goes through here |
| Public search | Web searches performed by Scout |
| Outbound | WhatsApp and SMS via Twilio |
| Enrichment + scraping | Apify actors — map searches, site contact extraction |
| External integrations | Composio tools that carry a cost (most are free) |
How Apollo Space protects your budget
Before each billable call, Apollo Space checks at multiple levels whether the action fits within the org’s budget:Wallet balance
If the wallet is empty, no new billable calls are authorized —
regardless of agent or user.
Configurable caps
You can set spending limits per organization, per agent,
and per user. Once a cap is reached, Apollo Space blocks new
calls in that dimension without affecting the others.
BYO-key — you own the vendor account
For most external vendors (Tavily, Twilio, Apify), you connect your own account. Here’s why:- The actual vendor invoice goes directly to you — Apollo Space is not a payment intermediary
- You keep control of your credentials and can revoke them at any time
- The Star deduction inside Apollo Space is an internal counter — it serves the caps system and gives you a unified view of consumption
History and audit trail
Every wallet transaction — credit received, usage debit, manual adjustment — creates a row in the history log, append-only. Nothing is deleted or edited retroactively. The result: you can answer “what happened to my balance on day X?” with precision at any time. The history is isolated per organization — no one from another org can see yours, nor can internal Apollo Space operators without explicit privilege. See Multi-tenant for the isolation model.Refunds and adjustments
- Refunds (disputed charge, retroactive plan cancellation) are processed automatically when the event arrives via Stripe
- Manual adjustments (welcome bonus, promotional credit, incident remediation) are made by the support team with a full trail in the history log
Next steps
Plans and packages
Overview of available plans and how to purchase packs.
Spending caps
How to configure limits per org, per agent, or per user.
Multi-tenant
How balances are isolated between organizations.
Integrations
What connects and what does (or doesn’t) draw from the balance.