HubSpot has rebranded itself around being an agentic platform, which in practice means AI is now built into nearly everything you touch in your portal. That's a good thing, but it also means it's easy to start using these tools before you've set up the groundwork that makes them actually useful, and before you understand what they cost.
Before you turn on any AI feature in HubSpot, there are three things you need to set up first:
- Give the AI context about your business
- Decide who has access to it
- Set your credit limits
Skip any of these and you'll end up with AI output that doesn't sound like you, tools available to people who shouldn't have them, or a bill you didn't see coming. None of the three take long to set up.
1. Give HubSpot's AI Context About Your Business
Navigate to Marketing, and then Brand in your portal. If you haven't been in here since before HubSpot leaned into AI, we encourage you to take a peek. Brand used to mean logos and colors. Now it's where you tell HubSpot's AI how to talk about your company.
Brand Kit still covers the basics: logos, colors, and preferred fonts. Brand Voice is where the real setup happens. You can upload writing samples for the AI to mimic, define brand attributes like personality and tone, and set terms to include or avoid. Channel optimization lets you go a step further and set different tones per channel, more formal and buttoned-up for email, more direct with a little personality for a blog, for example.
Brand Knowledge is the most involved section, and should be taken seriously. This is where you define your company profile, ideal customer profile, products and services, industry classification, content themes, and mission and vision. A website crawl tool can auto-populate a starting point from your existing site, but treat that as a rough draft, not a finished product. If your team hasn't sat down and defined your ICP or brand personality before, it’s time to do it. Without this information, your AI has less to work with, and can only sound as sharp as the context you give it.
2. Decide Who Has Access, and What HubSpot Can Do With Your Data
Click the gear icon in the top right, then go to Account Management > AI. Two important settings live here that are easy to overlook.
The first controls which of your users can access Breeze and HubSpot's other AI tools, and what data those tools can pull from, CRM data, customer conversation data, and file data.
The second is the AI model training toggle, which controls whether HubSpot can use your prompts and usage patterns to train its own AI models. Decide deliberately whether you want that on or off rather than leaving it at the default.
3. Set Your Credit Limits Before You Need Them
This is the one most teams miss until they get an unexpected bill. You'll need super admin access or billing permissions to see it. Click your company name in the top right, go to Account & Billing, then HubSpot Credits.
If you're only using the free credits HubSpot includes for every customer, you won't see options for maximum monthly credits or overage settings, since those free credits are already a hard cap. These settings only apply once you've purchased additional credits.
Once you have purchased additional credits, you'll choose how overages work when you hit your limit:
- Auto-upgrade moves you to the next credit tier as soon as you hit your cap, so you'll be billed for that higher tier every month going forward. This makes sense if a month or two of heavy usage is likely to reflect where your usage is headed.
- Pay-as-you-go lets you go over without committing to a permanent upgrade, at a higher per-credit cost. This fits usage that swings month to month.
- A hard maximum stops AI usage entirely once you hit your limit, then resets on your renewal date. Set this if you'd rather pause AI features for the rest of the month than risk an unplanned charge.
Beyond the account-wide limit, you can also cap credits tool by tool, content agent, customer agent, data agent, prospecting agent, and others, under feature credit limits. Each tool shows its own historical usage, which is worth reviewing before you set a cap rather than guessing.
Put your limits where the tools are doing the most work for you, and keep tighter caps on the ones that aren't.
FAQ
What actually triggers a credit charge in HubSpot?
This trips people up because the scope has expanded. Credits used to feel like an "AI only" thing, now they cover a wider set of actions across content agent, customer agent, data agent, prospecting agent, and several others, and HubSpot has been adding more over time. Rather than memorizing a list that's likely to be outdated in a few months, check Account & Billing → HubSpot Credits → Feature Credit Limits. It breaks down usage tool by tool, so you can see exactly what's consuming credits in your own portal instead of guessing from a general list.
My HubSpot portal shows I've used a certain number of credits, but I have no idea which feature is responsible. Where do I look?
Account & Billing → HubSpot Credits → Feature Credit Limits. Each tool listed there shows its own usage, so instead of one combined number, you get a breakdown by content agent, prospecting agent, data agent, and so on. Checking this monthly needs to become a habit, rather than only checking it when a bill looks off.
Can I cap how many credits a single agent or tool uses per month in HubSpot?
Yes, and this is important to do before you need it, not after. In Feature Credit Limits, you can set a monthly cap for each tool individually. Before you set a number, pull up that tool's historical usage so you're capping based on actual behavior rather than a guess. Put tighter limits on tools you're testing or that aren't core to your workflow yet, and looser ones on whatever's doing your heaviest lifting.
How do I set a credit limit in HubSpot so we don't go over accidentally?
Beyond the per-tool caps above, there's an account-wide setting in HubSpot Credits. You'll choose how overages behave once you hit your limit: auto-upgrade moves you to the next tier automatically (and you're billed for that tier going forward), pay-as-you-go lets you exceed your limit at a higher per-credit rate without a permanent upgrade, or a hard maximum stops AI usage until your renewal date. If you're not sure which fits, start with the hard maximum. It's the only option that guarantees no surprise charge while you learn your actual usage pattern.
I got an unexpected bill for credits I didn't think we were using in HubSpot. How does that happen, and how do I prevent it?
The most common cause is having auto-upgrade turned on by default without realizing it, combined with not checking Feature Credit Limits regularly. A workflow or agent can keep running and consuming credits quietly if nobody's watching that breakdown. The fix isn't a one-time setting, it's a habit: set a hard maximum or pay-as-you-go cap instead of leaving auto-upgrade on by default, set per-tool limits on anything you're not actively monitoring, and check the usage breakdown monthly rather than only after a bill surprises you.
Do Sandbox portals use credits in HubSpot the same way production does?
No. Sandbox credit usage is tracked separately from your production portal, so testing in Sandbox won't eat into your production credit pool. It's a reasonable thing to assume works the other way, so it's worth confirming for your own setup rather than assuming.
How do we figure out if paying for additional credits is worth it?
Don't estimate this up front, measure it. Run on the free credits HubSpot includes for a full billing cycle first and watch Feature Credit Limits to see what you're actually using and where. That gives you a real usage pattern instead of a guess. If you're consistently near the free limit on tools that are genuinely saving your team time, that's your signal to purchase, and you'll know which specific tools are worth prioritizing credits toward instead of buying a block and hoping it covers everything.
Want Help Setting This Up?
Getting context, access, and credits right before you roll AI out across your team takes some upfront thought, and it's easy to get partway through and lose momentum. If you want help setting this up properly the first time, let’s talk.
