- Knowledge Base
- AI
- AI
- Set up and use the customer health agent
BetaSet up and use the customer health agent
Last updated: March 31, 2026
Available with any of the following subscriptions, except where noted:
-
Service Hub Professional, Enterprise
-
Smart CRM Professional, Enterprise
With the customer health agent, you can assess the health of an account based on logged CRM activities, call transcripts, and public information available on the internet.
Please note: you can manage AI feature access in your AI settings and configure what data is shared. Review HubSpot's AI Trust FAQs and AI Model Cards for detailed information on AI security controls, data use, and compliance.
Set up the customer health agent
Permissions required Super Admin permission is required to set up the agent.
- In your HubSpot account, navigate to Breeze > Marketplace.
- Click Explore now.
- On the All Breeze Agents page, click the Customer Health Agent card.
- On the Customer Health Agent page, click Add beta agent.
- To open the agent, click Open. You'll be directed to the agent editor.
Configure the customer health agent
Once the customer health agent is added, Super Admins can manage access, add extra instructions, and automate the agent.
Permissions required Super Admin permission is required to configure the agent.
- In your HubSpot account, navigate to Breeze > Breeze Studio.
- On the Agents tab, hover over the Customer Health Agent card, click the verticalMenuIcon menu icon, and then select Configure. You can also click the agent card and then click Configure in the top right of the agent editor.
- To continue configuring the agent, learn more about customizing Breeze agents and managing access.
Use the customer health agent
The health of an account can be assessed by the customer health agent. The agent will assess logged CRM activities, call transcripts, and publicly accessible information on the internet.
Seats required An assigned Service Seat is required to use the customer health agent.
- In your HubSpot account, navigate to Breeze > Breeze Studio.
- On the Agents tab, click the Customer Health Agent card.
- In the Company ID field, enter the ID of the company.
- In the Company name or domain field, enter the name of a company (e.g., HubSpot) or the domain (e.g., hubspot.com).
- Click Run agent.
- Once the agent has assessed the company, view the Company Overview. You can view the following sections:
- Recent Engagements
- Account Health Risk & Grade
- Retention Playbook Example (If Account Graded ‘At-risk’)
- Summary
- To export the Company Overview, click Export PDF in the top left of the Output column.
View the customer health agent history
- In your HubSpot account, navigate to Breeze > Breeze Studio.
- On the Agents tab, click the Customer Health Agent card.
- In the History column, select the name of a previous run of the agent.
- In the Activities column, view the activities and actions the agent completed.
- In the Output column, view the output from the agent.