HubSpot 5 min read

HubSpot Credits: how to control AI agent costs

Every HubSpot AI agent now uses credits. See per-action rates, free simulations, run limits, spending caps and overage settings to keep costs predictable.

Crest Design
HubSpot credits usage gauge with spending limits

Since 23 July 2026, every AI agent in HubSpot consumes HubSpot Credits, including custom agents built in Agent Builder. If your team has started switching agents on, the bill now depends on how much work they do. The good news is that HubSpot gives admins solid controls: simulations that cost nothing, per-agent run limits, account and feature spending caps, and usage alerts.

This guide walks through how credits work at the time of writing (November 2026), what typical agent actions cost, and the settings worth configuring before you scale up.

How HubSpot Credits work

Credits are HubSpot's usage currency for agents, some automation and other usage-based features. The basics:

  • Every paid plan includes some credits. The amount varies by product and tier, and HubSpot lists it in its Product and Services Catalog rather than on the credits page.
  • Credits reset monthly and do not roll over. Unused credits expire at the end of each usage period.
  • Only paid seats can use them. Core, Sales, Service and Revenue seats, plus Partner seats, can consume credits. Free and view-only seats cannot.
  • You can add more. HubSpot's credits page lists capacity packs of 1,000 credits for USD 10 a month at the time of writing. Check the HubSpot Credits page for current pricing in your region.

What agents cost per action

Most HubSpot agents charge per completed outcome, not per step. These are rates from HubSpot's credits page at the time of writing:

Agent or feature Credits
Customer agent (messaging) 50 per resolution
Customer agent (voice) 50 per minute
Prospecting agent 100 per lead
Content agent 1,000 per piece of content
Nurture agent 10 per email
Data agent 10 per response
Knowledge base agent 200 per article
Revenue agent 500 per invoice

The spread matters. A nurture agent sending 5,000 personalised emails uses around 50,000 credits, while 50 content agent drafts uses the same amount. Custom agents vary further, because their cost depends on how complex each run is.

Step 1: Test agents in simulation first

HubSpot lets you run an agent in simulation without consuming credits. Simulations read CRM context but do not take CRM actions or change records. Note that a simulation may still run any MCP tools you have configured, so use sample input data.

  1. 1 Go to Agents, open Agent Hub and select the Agents tab.
  2. 2 Open the agent's editor and click Test in the top right.
  3. 3 Enter the required details and start the run.
  4. 4 To compare runs, open View history in the Test panel. Each simulation shows its estimated credits, timestamp and output.

Run a handful of realistic examples, including awkward ones, and note the average. HubSpot is clear that estimates can differ from the actual cost of a live run.

Step 2: Set a monthly run limit on each agent

A run limit is the simplest guardrail. When an agent reaches its monthly limit, it stops running until the next period.

  1. 1 In Agent Hub, open the agent's editor.
  2. 2 Click the three-dot menu and choose Edit run limit.
  3. 3 Review the average estimated credits per run.
  4. 4 Switch on Monthly agent run limit and enter a number of runs.
  5. 5 Check the estimated monthly credit range, then click Update.

For a customer-facing agent, think about what should happen when it stops. Make sure conversations route to a human inbox rather than going unanswered.

Step 3: Set account and feature spending caps

Run limits work per agent. Spending caps work across the account. Go to your account name, then Account & Billing, the Usage & Limits tab and the HubSpot Credits tab.

  • Account cap. Under "Maximum monthly credits", click Edit. HubSpot sets the account spend limit automatically at 50% above your total monthly credits, so review whether that suits you.
  • Feature caps. Under "Feature credit limits", click View, choose a feature and add a limit. These are spending ceilings, not reserved allocations, and cannot exceed the account cap.
  • Action caps. For buyer intent, you can also limit individual actions.

HubSpot does not switch feature limits on by default, so this step is worth doing deliberately.

Step 4: Choose what happens when you run out

Before any capacity packs are added, usage-based features pause once included credits are used up. If you buy more, there are two overage behaviours:

  • Auto-upgrade moves the account to a larger capacity pack for the rest of the commitment term. It is the default for credits bought before 16 September 2026.
  • Pay-as-you-go charges each credit above your monthly limit at the current overage rate, invoiced monthly in arrears. It is the default for credits bought on or after 16 September 2026, and the limit resets each period.

Only Super Admins and Billing Admins can turn on overages or change this setting. In October 2026, HubSpot also announced more flexibility to move budget between seats and credits mid-contract, as reported by trade press, so ask your account manager if your usage pattern is shifting.

Simulate, cap each agent, cap the account, then decide on overages. In that order.

Step 5: Watch the alerts and review monthly

Billing contacts and Super Admins receive banners and emails at 75%, 85% and 90% of the credit limit, and again when it is exceeded. Make sure your billing contacts are people who will act on them. Once a month, open the HubSpot Credits tab, look at usage by feature, and ask whether each agent's output justified its cost. Pausing a feature is one click from that view.

Frequently asked questions

Do simulations use credits?

No. HubSpot's documentation says simulations do not consume credits and do not change records.

Do unused credits carry over?

No. They expire at the end of each monthly period.

Who can see and change credit settings?

Super Admins and Billing Admins manage overages. HubSpot recommends that one of them reviews usage regularly.

Is Agent Builder available on every plan?

HubSpot launched Agent Hub and Agent Builder in public beta for Professional and Enterprise customers on 23 July 2026. Check your portal for current availability.

Need help with HubSpot agents and automation?

We help teams plan, build and govern HubSpot agents and workflows so that costs stay predictable, as part of our HubSpot services and AI automation work. If you are deciding where to start, our post on the workflow automations to set up first is a useful companion. When you are ready, talk to us.

Sources: HubSpot: Test and control agent credit usage, HubSpot: Manage HubSpot Credits, HubSpot Credits, Meet Agent Hub and Agent Builder, HubSpot adds AI spend caps and flexible credit billing

(over to you)

Planning a build like this?

Tell us what you're building and we'll come back with ideas and next steps.