- Home
- HubSpot automation
- HubSpot reporting
HubSpot's custom reports need Professional, and its Reporting API can't build one yet
Every HubSpot plan has dashboards, which group reports in one view. Custom reports come from the report builder, on Professional and Enterprise plans. HubSpot's Reporting API is in public beta, and it can't yet create a report or read the query and chart settings behind one.
Every HubSpot plan has dashboards
HubSpot’s dashboards guide lists them for all products and plans. In HubSpot, a dashboard gathers reports in one view for a certain purpose or a certain user. To make one, go to Reporting, then Dashboards, and click Create dashboard. You can start from scratch or from a template.
Five rules shape how dashboards behave:
- How many. The maximum depends on your account’s highest subscription tier. HubSpot points to its Product and Services Catalog for the number. That part of the catalog did not come through in our read, so we can’t quote it.
- Who sees it. Picking specific teams and users for a dashboard is Enterprise only.
- What they see. Dashboard access does not override report sharing, folder permissions or data permissions. A user can open a dashboard and still find a report they can’t read.
- Favorites. Each user can add up to 10 favorite dashboards.
- Restores. Restore a deleted dashboard, and any of its reports deleted in the last 14 days come back with it.
The custom report builder needs Professional or Enterprise
HubSpot’s custom report builder reads several data sources across HubSpot in one report. It comes with the Professional and Enterprise editions of Marketing, Sales, Service, Data, Content and Revenue Hub. These limits decide how far one report goes:
Scroll the table sideways to see every column.
| Report part | Most it takes |
|---|---|
| Vertical bar, line or area chart | 12 fields on the Y-axis, or one field on each axis plus one Break down by |
| Pivot table | 30 fields, in four rows and four columns |
| Measures in one report | 12 |
| Break down by values shown on a dashboard | 99 |
Existing reports can’t be merged into one. If two reports need to become one, build a new report from the data sources. Datasets and formula fields in the builder need Data Hub Enterprise. A report with more than 99 values in its Break down by field won’t show on a dashboard, only in the reports tool.
Breeze uses no credits; the data agent does
Breeze Assistant comes with HubSpot subscriptions at no extra cost. HubSpot says it doesn’t consume HubSpot Credits, but starting an AI agent run with it may. It pulls from your CRM data and customer records. A saved prompt can start a chat on a schedule, such as a weekly deal pipeline summary. When it writes a report or a spreadsheet, the result is saved as a versioned artifact. HubSpot’s guide also covers using it to generate data visualizations.
The data agent answers custom questions about any contact or company from the signals already in your CRM. Marketing, Sales, Service, Data and Content Hub get it from Starter up. Smart CRM and Revenue Hub need Professional or Enterprise. It costs credits. HubSpot Credits are used each time it answers one prompt for one record. Smart Properties fill custom properties with its answers. Smart Columns add AI-researched columns to datasets in Data Studio. HubSpot warns against putting sensitive information in your prompts.
The beta Reporting API can’t build reports
HubSpot’s Reporting API manages the details around reports, not the reports themselves. In its words, the beta handles report and dashboard metadata: reading, searching, updating, restoring, archiving, exporting, ownership and permissions. It does not yet support a report’s configuration. That means the query and chart settings that define what a report shows. So it can’t create a report, or read or change those settings.
- Read one report’s details with a GET request to /analytics/reporting/2027-03-beta/reports/{reportId}.
- Exports need a real user. They work only from apps with user-level access, and an export call from an account-level app fails.
- Search is eventually consistent. A change can take a few seconds to show up.
So the API suits housekeeping, such as moving dashboard owners when someone leaves. It can’t yet copy a report’s logic from one account to another.
Four more routes move numbers in or out of HubSpot
A few routes reach data the Reporting API can’t:
- Forecasts API. HubSpot made it generally available in its Fall 2026 Spotlight, for Sales Hub and Service Hub Professional and Enterprise. It is read-only. It feeds the forecasts your team submits to BI tools and data warehouses.
- MCP server tools. HubSpot’s query_crm_data tool runs SQL with HubSpot’s own extensions, but no joins. Its campaign attribution tool covers closed-won deals only. A content analytics tool runs totals and time series for landing pages, website pages and blog posts. More on the server is on our HubSpot MCP page.
- CRM Search API. One query stops at 10,000 results, so a large pull has to be split into smaller queries.
- Datasource Ingestion API. The same Spotlight describes it. Data you send doesn’t need to map to any HubSpot object, and it lands in Data Studio for datasets, reports and activation. The post names no plan for it, and datasets in the report builder need Data Hub Enterprise.
ERP numbers reach HubSpot reports only once they land there
HubSpot reports on what HubSpot holds. Its NetSuite app syncs contacts, companies, deals, invoices and sales orders, so those can feed a HubSpot report. For an ERP with no HubSpot app, the numbers come in through HubSpot’s API or the Datasource Ingestion API first.
A custom agent can do the reading a report can’t. It can pull the week’s open deals from HubSpot, compare them with unpaid invoices in your ERP, and write a short summary to a property or an email.
For other automation jobs, see HubSpot automation. Our team builds HubSpot agents on Anthropic’s Claude, and the jobs they take on are on HubSpot AI agents.
Questions
How do I create a dashboard in HubSpot?
Go to Reporting, then Dashboards, and click Create dashboard in the upper right. In some accounts Reporting sits under More. You land in the dashboard library, where you start from scratch or pick a template. Then add reports and set who can see the dashboard. Picking named teams and users is an Enterprise feature.
Can HubSpot's AI build reports?
Partly. Breeze Assistant comes with HubSpot plans at no extra cost. It doesn't use HubSpot Credits, though starting an AI agent run with it may. It can draw charts, and a report it writes is saved as a versioned artifact. The data agent answers questions about a contact or company. It uses credits for each answer, and most hubs get it from Starter up.
Is there a HubSpot reporting API?
Yes, as a public beta. HubSpot's Reporting API reads, searches, archives and exports reports and dashboards, and manages who owns them. It does not yet support a report's configuration, which is the query and chart settings behind it. Export calls work only from apps with user-level access, because a real user has to trigger the export.
How many dashboards can we have in HubSpot?
It depends on the highest subscription tier in your account. HubSpot's guide says an account with Marketing Hub Enterprise and Sales Hub Professional gets the Enterprise number. The guide points to HubSpot's Product and Services Catalog for the counts. That part of the catalog did not come through when we read it, so we can't quote them here.
Can we combine two HubSpot reports into one?
No. HubSpot says existing reports can't be merged into a single report. Build a new custom report with the data sources you need instead. If the data won't fit one report, HubSpot suggests a dataset, which needs Data Hub Enterprise in the report builder, or keeping both reports side by side on a dashboard.
Can HubSpot report on our ERP data?
Only on data that sits in HubSpot. HubSpot's own ERP apps are one way in, and the ERP section on this page names what the NetSuite app brings. HubSpot's Fall 2026 Spotlight also describes a Datasource Ingestion API that loads data into Data Studio without mapping it to a HubSpot object. Or an agent reads both systems and writes a summary where your team will see it.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- HubSpot Knowledge Base, manage dashboards (updated 20 October 2026)Read 18 Nov 2026
- HubSpot Knowledge Base, create reports with the custom report builder (updated 16 November 2026)Read 18 Nov 2026
- HubSpot Knowledge Base, understand Breeze AssistantRead 18 Nov 2026
- HubSpot Knowledge Base, set up and use the data agentRead 18 Nov 2026
- HubSpot developer docs, Reporting API (public beta)Read 18 Nov 2026
- HubSpot developer changelog, Fall 2026 SpotlightRead 18 Nov 2026
- HubSpot developer docs, integrate with the HubSpot MCP server (tool list)Read 18 Nov 2026
- HubSpot developer docs, search the CRMRead 18 Nov 2026
- HubSpot, Breeze AssistantRead 18 Nov 2026
- HubSpot, Agent HubRead 18 Nov 2026
- HubSpot Knowledge Base, connect HubSpot and NetSuiteRead 18 Nov 2026
Plan your HubSpot reporting
Bring the reports your team builds by hand each week and the systems the numbers come from. The first call is free.