Test and control agent credit usage

Summary

Simulate AI agent runs without consuming credits to estimate HubSpot Credit costs. Then, set guardrails to cap HubSpot Credit usage per agent. 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 AI agents started consuming HubSpot Credits. It's strongly recommended to run agent simulations to estimate credit costs per run and 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, navigate to Agents > Agent Hub.
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, navigate to Agents > Agent Hub.
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 the number of times an AI agent can run per month to cap HubSpot Credit usage. These limits apply on a per-agent basis, and the agent stops running once it reaches the set limit.

1. In your HubSpot account, navigate to Agents > Agent Hub.
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.