Test and control agent credit usage

Simulate agent runs without consuming credits to estimate HubSpot Credit costs, then set monthly run limits to control how often agents run. Since credit costs vary by agent complexity, simulating runs before going live helps you plan usage and avoid unexpected charges.

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 simulate runs to estimate credit costs per execution and set monthly run limits for your agents to avoid unexpected charges.

Run agent simulations without consuming credits

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

Set boundaries for an agent to cap HubSpot Credit usage. These limits apply on a per-agent basis.

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.