Review estimated credit costs when using agents

To forecast and control how your account uses HubSpot Credits, review estimated credit costs for your agents and set limits on how often they run. Credit costs vary by agent complexity, so reviewing estimates before full runs helps you plan your usage. Check estimated costs and set monthly run limits in the agent builder. 

Learn more about using agents and assistants in HubSpot.

Before you get started

Estimated credit costs per run are calculated based on the agent's current run and complexity. This can sometimes vary from the actual costs of each agent's run.

Please note: on July 23, 2026, all agents started consuming HubSpot Credits and all agents accessible in the agent builder became available to accounts with a Professional or Enterprise subscription. It's strongly recommended to review your estimated credit costs per execution and set monthly run limits for your agents to avoid unexpected charges.

Review estimated credit costs in the agent builder

Run simulations for individual agents. This allows you to test an agent, including reading CRM context, without consuming credits. You'll see the input, agent reasoning and activity, and the agent output. The output display mirrors a regular agent run, without taking CRM actions or making any changes. If configured, the agent may run MCP tools, so it's recommended to use sample input data.

To run an agent simulation:

1. In your HubSpot account, click More, then navigate to Agents > Agent Hub. If More doesn't appear in your account, navigate to Agents > Agent Hub directly.
2. Click the Agents tab.
3. Click Edit on an agent card.
4. In the upper right, click Test.
5. Enter the required details to test the agent.
6. Click Test agent to start the agent run.

To review previous agent simulation runs:

1. In your HubSpot account, click More, then navigate to Agents > Agent Hub. If More doesn't appear in your account, navigate to Agents > Agent Hub directly.
2. Click the Agents tab.
3. Click Edit on an agent card.
4. In the upper right, click Test.
5. In the Test agent panel, click View history.
6. Click the name of a simulation to review details such as the estimated number of credits consumed, the timestamp of the run, and the output.

Set monthly run limits per agent in the agent builder

1. In your HubSpot account, click More, then navigate to Agents > Agent Hub. If More doesn't appear in your account, navigate to Agents > Agent Hub directly.
2. At the top, click the Agents tab.
3. Click Edit on an agent card.
4. In the agent builder, click the verticalMenuIcon three vertical dots icon and select Edit run limit. 

5. In the Agent run limits panel, review the average estimated credits per run.
6. Toggle the Monthly agent run limit switch on to set a monthly run limit for the agent.
7. In the Agent run limit text field, enter the number of times you want the agent to run this month.
8. Review the estimated credit usage range. The range will automatically update as you adjust the run limit (e.g., 900–1,000 credits/month) based on the average credits consumed per run.
9. In the lower right, click Update.