HubSpot Customer Health Scores: How To Set Up And Use The Customer Success Workspace
How a HubSpot health score is calculated, which signals belong in it, how to read its history, and how to turn a falling score into a renewal saved. Every product detail is checked against HubSpot's own documentation.
Key Takeaways
- A HubSpot health score is a points-based score that the customer success workspace calculates for each customer account from the events and property values you choose, then maps to a label such as Healthy, Neutral or At-risk.
- The customer success workspace and health scores need Service Hub Professional or Enterprise and an assigned Service Seat. Several scores per account, team workspaces and custom-object accounts are Enterprise only.
- Scores are built from score groups (events or properties, each with a points cap), with optional decay, then thresholds and labels. Turning a score on creates Health score and Health status properties you can use anywhere in HubSpot.
- The trend matters more than the number. The Health Score card shows a monthly score trend and the events behind each change, and the workspace raises an alert when a customer's health status changes.
- A score is only as good as its inputs. Get usage, support and survey data into HubSpot reliably first, then test the score against customers who have already churned or renewed.
A HubSpot health score tells a customer success team which accounts need attention today, before a renewal conversation turns into a cancellation notice. Without one, customer success managers (CSMs) scan ticket queues, call notes and usage reports account by account, and the quiet accounts that are drifting away are the ones nobody looks at.
The economics explain why this matters. Research by Frederick Reichheld of Bain & Company, cited by Harvard Business Review, found that increasing customer retention rates by 5% increases profits by 25% to 95%. This guide explains how HubSpot's customer success workspace and health scores work today, which subscription they need, how to choose and weight signals, how to read score history, and how to turn a falling score into action. It is written for growing and mid-market companies running customer success on HubSpot, and every product capability is checked against HubSpot's Knowledge Base as of October 2026.
What Is The HubSpot Customer Success Workspace?
The customer success workspace is a dedicated area in HubSpot Service Hub where CSMs manage their book of business: daily tasks, customer views, health scores, renewals and meetings in one place. It sits under Service > Customer Success and is available on Service Hub Professional and Enterprise, with an assigned Service Seat for full use.
HubSpot has expanded the workspace steadily since it launched in beta. In 2025 it added real-time alerts when health scores change, support for multiple teams, leader reporting and a board view on the Customers tab. In 2026 it added a system-managed Current Customer property, onboarding plans and a more detailed score history. Today it has seven tabs:
| Tab | What a CSM uses it for |
|---|---|
| Summary | Today's tasks, health status alerts, customer views, a health score summary (average score and the share of customers At-risk, Neutral and Healthy), the day's schedule and up to five reports. |
| Customers | The CSM's accounts in list or board view, with saved views such as "Owned by me" and a record preview that shows the current health score and status. |
| Projects | Onboarding and implementation projects, on the Projects object or a custom object. |
| Revenue | Renewal and expansion records (deals or a custom object) by pipeline stage. |
| Actions | Overdue and upcoming tasks, plus alert management. |
| Schedule | A day, week or month calendar of tasks and meetings. |
| Dashboards | Up to five dashboards that everyone with access to the workspace can see. |
During setup, an admin chooses which object represents a customer account (contacts, companies or, on Enterprise, a custom object), how a current customer is defined, which user property holds the CSM owner, an optional renewal date property, and up to two objects for revenue. Those choices decide what health scores can be applied to, so make them deliberately. For the wider Service Hub picture, see our HubSpot Service Hub services.
Which HubSpot Subscription Do You Need For Health Scores?
Health scores and the customer success workspace need Service Hub Professional or Enterprise. HubSpot states that customer success management is not included in the free or Starter tiers. Creating a score also needs the Manage Customer Success Settings permission and a Service Seat. Professional covers one score and one workspace; Enterprise adds multiple scores and team workspaces.
| Capability | What HubSpot requires |
|---|---|
| Customer success workspace | Service Hub Professional or Enterprise. Full use needs a Service Seat; a super admin without one sees only the Summary tab. |
| Create a health score | Service Hub Professional or Enterprise, Manage Customer Success Settings permission and a Service Seat |
| Several health scores, each with its own properties | Service Hub Enterprise (up to 50 scores per account, each applied to up to five segments) |
| Workspaces | One on Professional; up to five team workspaces on Enterprise |
| Custom object as the customer account | Enterprise |
| NPS, CSAT and CES surveys | Service Hub Professional or Enterprise |
| Playbooks | Sales Hub or Service Hub Professional or Enterprise, with an assigned seat |
| Workflows that act on health status | A Professional or Enterprise hub that includes workflows |
| Customer health agent (beta) | Service Hub or Smart CRM Professional or Enterprise, HubSpot Credits, and a Service Seat to use it |
| Product usage and activation tracking (beta) | Service Hub Professional or Enterprise; up to 10 tracked events per account |
Sources: HubSpot Knowledge Base articles on using the workspace, setting it up, creating a health score and the customer health agent, checked October 2026. HubSpot changes tiers and betas often: confirm against your own account before you plan a build.
How Is A HubSpot Health Score Calculated?
A HubSpot health score is the sum of points a customer earns or loses against rules you define. Rules sit in score groups built on either events (meetings, calls, tickets, custom events) or property values (NPS rating, plan, CSM sentiment). Each group has a maximum, points can decay over time, and the total maps to a label through thresholds you set.
Score groups
A group holds related rules and contains either events or properties, never both. HubSpot offers five ready-made groups (1:1 Engagement, 1:1 Call Engagement, Support Tickets, CSM Sentiment and NPS), or you can start from scratch.
Positive and negative rules
Each rule adds points for healthy behavior or subtracts points for risk. Event rules can set a timeframe and a frequency (exactly, between, at least), and conditions on the same event combine with AND logic.
Caps and limits
Every group has an editable maximum, so one noisy signal cannot dominate the score. A single rule can also be limited, for example so that only the first two form submissions count.
Decay
Optional decay reduces the points from an event by a percentage after a set period (1, 3, 6 or 12 months), so a burst of activity last year does not keep a quiet account looking healthy today.
Associated records
Rules can score activity on associated records, such as tickets or contacts linked to a company, and roll it up by sum, average, minimum or maximum, filtered by association label.
Thresholds and properties
Thresholds map score ranges to a label and colour. Turning a score on creates a Health score property (the points total) and a Health status property (the label), which update automatically.
Because Health score and Health status are ordinary CRM properties, they work anywhere a property does: in segments, views, reports and workflow criteria. That is what makes the score useful beyond the workspace. The score itself only describes risk; the properties are what let you act on it.
Which Signals Should A Customer Health Score Include?
A good customer health score combines four kinds of signal: how much the customer uses your product, how they engage with your team, how much support friction they hit, and what they tell you in surveys. Choose the signals that actually separated churned customers from renewed ones in your own history, not the ones that are easiest to report.
Start by looking back. Pull the accounts that churned or downgraded in the last year and the ones that renewed or expanded, and compare what was different in the months before. Talk to your CSMs and support team too: they often know the warning signs (a champion leaving, a missed business review) long before any report does. Then map each signal to the HubSpot mechanism that can score it.
| Signal | Where it lives in HubSpot | Direction | Example rule (illustrative) |
|---|---|---|---|
| Product usage | Custom events sent from your app, or synced properties such as last login date | Positive when frequent; negative when falling | +10 if a core feature event occurs at least 4 times in 30 days |
| 1:1 engagement | Meetings, calls and emails logged on the account (ready-made groups) | Positive | +10 if a meeting is completed in the last 90 days |
| Support friction | Tickets associated with the company (Support Tickets group) | Negative | −5 for each high-priority ticket open longer than 7 days, capped at −20 |
| Survey sentiment | NPS, CSAT and CES response properties (NPS group) | Positive or negative | +15 if the last NPS rating is 9–10; −15 if it is 0–6 |
| CSM sentiment | A property your CSMs update after each check-in (CSM Sentiment group) | Positive or negative | −10 if CSM sentiment is "At risk" |
| Commercial context | Renewal date, plan, contract value or seats used, as properties | Usually context, not points | Use for segments and prioritization rather than health points |
The point values above are a starting model, not a benchmark. Keep the first version small (four or five groups) and resist scoring contract value as health: a large account is more important, not healthier. Segment by value instead, and let health tell you which of those important accounts is slipping. Remember too that if your customer object is the company, signals logged on contacts need association rules to reach the company's score.
How Do You Set Up A Health Score In HubSpot?
Set up the workspace objects first, then create the score from the workspace settings: pick the customer segments, build score groups and rules, set thresholds and labels, test it on real records, preview the distribution, and turn it on. Expect to recalibrate after a month or two of live data.
A common question is how wide each band should be. There is no correct answer in the abstract. Set thresholds so that the At-risk band holds a number of accounts your CSMs can actually work each week. If a third of your base lands in At-risk on day one, the label stops meaning anything.
How Do You Read Health Score History And Trends In HubSpot?
Open the Health Score card on a customer record and click View score history. HubSpot shows a monthly score trend graph and a score history chart listing the events and property changes that moved the score, filterable by date range. In the workspace, alerts flag each health status change, and Enterprise users can track the average score over time.
A score is a snapshot; the direction tells you more. An account at 72 that was at 90 last quarter deserves attention before an account that has sat at 60 all year. Since August 2026, HubSpot's score history shows the specific events and properties behind each change with timestamps, so a CSM can see why a score fell (two escalated tickets, a detractor NPS response, no meetings in 90 days) without rebuilding the calculation by hand.
Patterns
Recurring shapes across many accounts, such as scores dipping around the third month after onboarding or before each renewal. A pattern tells you where to place a proactive check-in for every customer.
Anomalies
A sudden drop or jump on one account. Read the score history to find the event behind it: a burst of tickets after a release, a champion who stopped attending calls, or new excitement after a feature launch.
Distribution
The share of customers in each band over time. The Summary tab shows the current split; Service Hub Enterprise adds score distribution and average score over time for portfolio-level trends.
Anomalies deserve a fast response. PwC's Experience is everything survey of 15,000 consumers found that 32% would walk away from a brand they love after just one bad experience. A sharp drop driven by a support incident is exactly that moment, and alerts expire after 14 days, so someone needs to own them daily.
How Do You Turn Health Scores Into Customer Success Actions?
Pair every health status and trend with a defined response, an owner and a deadline. Use the Health status property to build workspace views and workflows that create tasks or notify the CSM, attach a playbook for the conversation, and treat healthy, growing accounts as expansion and advocacy opportunities, not just accounts to leave alone.
| Score trend | What it usually means | Response |
|---|---|---|
| Declining | Usage, engagement or sentiment is slipping | CSM check-in within days; read the score history for the cause; offer targeted training if usage fell |
| At-risk, renewal near | Revenue at risk this quarter | Escalate to the CS lead, run a recovery plan with an executive sponsor, and open the renewal conversation early |
| Fluctuating | Inconsistent adoption or recurring incidents | Investigate the events behind each swing; fix the root cause, which is often a product or support issue |
| Improving | Recent work is paying off | Acknowledge progress and ask the customer what is working, then repeat it with similar accounts |
| Consistently high | Satisfied, engaged customer | Explore expansion with sales, and ask for a review, referral or case study |
Three HubSpot tools turn those responses into routine work:
Workflows on the Health status property
AutomationBest for: making sure no status change waits for someone to notice it.
Because Health status is a standard property, a filter-based workflow can enroll companies when it becomes At-risk, then create a task for the CSM owner, send an internal notification to the CS lead, or open a renewal deal if the renewal date is close. Turn on re-enrollment so an account that recovers and slips again is caught a second time. For the wider lifecycle, see our guide to HubSpot workflows for SaaS, which includes churn-risk and renewal workflows.
Playbooks for the conversation
ConsistencyBest for: giving every CSM the same questions and next steps for a risk call or business review.
HubSpot playbooks appear as cards on company, contact, deal and ticket records and can capture answers into properties, which can then feed the CSM Sentiment group of the score. Recommendation rules can also surface a playbook automatically when a record's properties match, for example when Health status is At-risk. See how to use HubSpot playbooks to standardize these conversations.
The customer health agent (beta)
AI · BetaBest for: a second opinion on accounts before a renewal or risk review.
HubSpot's customer health agent assesses an account from logged CRM activity, call transcripts and public web information, and returns recent engagements, a health risk grade, a summary and, for at-risk accounts, an example retention playbook. It is a beta that uses HubSpot Credits, and it complements a rules-based health score rather than replacing one: the score is transparent and consistent, the agent adds context. Our AI in HubSpot page covers how we deploy Breeze agents responsibly.
How Do NPS, CSAT And CES Surveys Feed A HubSpot Health Score?
HubSpot's NPS, CSAT and CES surveys (Service Hub Professional or Enterprise) store each response in properties that can be scored in a health score's NPS or property groups, used in segments and reports, and trigger follow-up workflows by response band. Survey sentiment is a strong signal, but it is sparse, so weight it alongside behavioral data.
| Survey | Question and scale | Bands HubSpot uses | Best moment to send |
|---|---|---|---|
| NPS (customer loyalty) | Likelihood to recommend, 0–10 | 0–6 Detractor, 7–8 Passive, 9–10 Promoter | On a regular cadence; HubSpot suggests quarterly, every 6 months or every 12 months |
| CSAT (customer satisfaction) | Satisfaction with an interaction, Unhappy / Neutral / Happy | Unhappy, Neutral, Happy | After a key interaction, by email, chat or on a web page |
| CES (customer effort) | Ease of getting an issue resolved, seven-point agree–disagree scale | 1–3 Difficult, 4–5 Neutral, 6–7 Easy | After a ticket reaches a chosen pipeline status, by email |
NPS is calculated as the percentage of Promoters minus the percentage of Detractors, and HubSpot's own estimate of a typical NPS response rate is 5–15%. That is why an account with no survey response should not be scored as unhealthy: treat a missing response as neutral, and let usage and engagement carry the score between surveys. Each survey can create workflows per band, so a detractor response can create a task for the CSM the same day. See HubSpot's customer loyalty survey guide for setup.
What Mistakes Make HubSpot Health Scores Unreliable?
Most health scores fail for structural reasons, not because the points are slightly off. The five below come up repeatedly in the HubSpot portals we audit, and each one makes CSMs stop trusting the score, which is the real failure.
How Do You Know Your Health Score Is Working?
A health score is working when it predicts outcomes and changes behavior. Check that At-risk accounts churn at a clearly higher rate than Healthy ones, that CSMs act on alerts quickly, and that recovered accounts renew. Measure gross and net revenue retention for the scored segments before and after the score went live.
| Question | Metric to track | Where to find it |
|---|---|---|
| Does the score predict churn? | Churn and renewal rate by health status at the start of each quarter | Report on Health status with renewal deals or lifecycle stage |
| Do CSMs act on it? | Time from an At-risk alert to a logged CSM touch | Alerts on the Actions tab and the task and meeting activity on the account |
| Do interventions work? | Share of At-risk accounts that recover to Neutral or Healthy | Health status changes over time; score history per account |
| Does it protect revenue? | Gross and net revenue retention for scored segments | Revenue tab pipelines and renewal deal reports |
| Does it surface growth? | Expansion pipeline from consistently Healthy accounts | Deals created from Healthy segments |
The economics are why this is worth the effort. The same HBR article notes that acquiring a new customer costs anywhere from five to 25 times more than retaining an existing one, depending on the study and industry. A score that helps you save even a handful of renewals a quarter usually pays for the work of building it. If renewal and billing data live outside HubSpot, connecting them is often the larger part of the project. See how we approach Salesforce and HubSpot integration when revenue data lives in both systems.
How Twopir Consulting Helps Build HubSpot Health Scores
Twopir Consulting is a Salesforce Partner and HubSpot Partner. We implement, rescue, optimize, and integrate complex CRM and revenue systems, and we help growing and mid-market companies solve complex CRM, integration, and business system challenges. For customer success teams on HubSpot, that means setting up the workspace objects, getting usage, support, billing and survey data into HubSpot reliably, building and calibrating the health score, and wiring the workflows and playbooks that act on it.
We sequence the work deliberately: data and ticket hygiene first, health scoring last, because a score built on unreliable inputs is worse than no score at all. Our HubSpot Service Hub page publishes anonymized examples, each scoped to the client it was measured on and not a benchmark, including a US healthcare technology platform whose customer health scoring flagged churn risk an average of six weeks before renewal. If you want an outside view of your current portal first, start with a HubSpot audit.
Build A Health Score Your CSMs Trust
In a 30-minute discovery call, we review your customer success setup in HubSpot, check whether your usage, support and survey data can support a reliable health score, and outline the signals and workflows to start with.
Schedule a Discovery CallThe Bottom Line
HubSpot's customer success workspace gives CSMs one place to manage their accounts, and its health score turns scattered signals into a single, explainable view of risk. The value comes from what sits around the score: reliable inputs, thresholds that produce a workable At-risk list, a habit of reading the trend and the events behind it, and a defined response to every change.
- 1
Confirm you have Service Hub Professional or Enterprise and Service Seats for your CSMs, and decide whether you need Enterprise for multiple scores or team workspaces.
- 2
Choose signals from your own churn and renewal history, and get usage, support and survey data flowing into HubSpot before you score it.
- 3
Keep the first score small, with group caps and decay, and test it against accounts you know churned or renewed before turning it on.
- 4
Watch the trend and the score history, not just the number, and give alerts a daily owner.
- 5
Wire Health status into views, workflows and playbooks, and review whether the score predicts churn every quarter.
Frequently Asked Questions
A HubSpot health score is a points-based score that the customer success workspace calculates for each customer account from the events and property values you choose, such as meetings, support tickets and NPS ratings. Thresholds map the total to a label like Healthy, Neutral or At-risk, stored in Health score and Health status properties.
Health scores and the customer success workspace are part of Service Hub Professional and Enterprise, and creating a score needs a Service Seat and the Manage Customer Success Settings permission. They are not in the free or Starter tiers. Running several health scores, each with its own properties, needs Service Hub Enterprise.
HubSpot allows up to 50 health scores per account, and each score can apply to up to five contact or company segments. Running multiple scores, each with its own Health score and Health status properties, is a Service Hub Enterprise feature.
Open the Health Score card on the customer record and click View score history. HubSpot shows a monthly score trend graph and a score history chart listing the events and property changes that raised or lowered the score, with a date filter. See score calculations opens the rules behind it.
Yes. Turning on a health score creates Health score and Health status properties, which work like any other property. A filter-based workflow can enroll accounts when Health status becomes At-risk and then create a CSM task, notify a manager or open a renewal deal, with re-enrollment on so repeat slips are caught.
Yes, but not on its own. HubSpot includes a ready-made NPS score group, and detractor responses are a strong risk signal. Survey responses are sparse, though, so weight NPS alongside usage, engagement and support data, and treat a missing response as neutral rather than negative.
The customer health agent is a beta AI agent for Service Hub or Smart CRM Professional and Enterprise that uses HubSpot Credits. It reviews logged CRM activity, call transcripts and public web information, then returns a health risk grade, a summary and, for at-risk accounts, an example retention playbook. It complements a rules-based health score.
