A reference of the errors and dead ends users hit most often, with the symptom, the cause, and what to do about it.
Save validation errors #
"Name is required" #
You pressed Save with the Name field empty. The connector reports the missing required field in a blocking message box.
Fix: dismiss the message, fill in a name, save again.
"At least one object is required" #
You saved a data source with a name but no HubSpot objects attached.
Fix: dismiss the message, expand a HubSpot object in the tree and tick at least one property, then save again. See Create a data source.
"Cannot save: one or more filter expressions are invalid" #
An OData filter expression somewhere on the data source fails to parse. The object with the broken filter is highlighted in the form, and the editor under it shows an inline error pointing to the first parse failure.
Fix: open the broken object, switch to the OData filter editor if you’re in the basic one, correct the expression, and save again. See Filter rows.
Power BI authentication errors #
401 Unauthorized in Power BI Desktop or Power BI service #
Power BI failed to authenticate against the connector. Causes:
- The personal access token used was revoked or auto-expired. Look for it on Access Tokens with status Revoked or Expired.
- The user name in Power BI doesn’t match the connector account that minted the token.
- Power BI cached a stale token after you minted a new one.
Fix: mint a fresh token in the connector. In Power BI Desktop, update credentials under File → Options and settings → Data source settings. In the Power BI service, update credentials on the dataset under Settings → Data source credentials.
403 Forbidden after the data source worked before #
Your token authenticates, but the connector refuses to return data for this data source. Two common causes:
- The owner removed you from the sharing list. See See what’s been shared with you.
- The owner deleted the data source. The URL still resolves but the row is gone.
Fix: ask the owner. If they intentionally removed you, this is the expected outcome.
HubSpot catalog and metadata #
The HubSpot object catalog is empty #
The Add HubSpot Service dialog returns no rows or fewer rows than expected.
- The HubSpot OAuth connection has been revoked or expired. Ask your HubSpot Super Admin to reinstall the connector from the HubSpot Marketplace.
- The HubSpot OAuth grant doesn’t include the scopes needed for the requested objects. Reinstall the connector and approve all requested scopes. See the technical guide for the on-premise side.
- The catalog response cached an earlier failure. Try again in a minute. If the failure persists, the HubSpot API may be experiencing an incident — check status.hubspot.com.
"Loading service metadata" takes more than a minute #
First-load metadata fetches are slow for large HubSpot objects. The HubSpot back end can take 30–90 seconds to produce the metadata document. Wait it out. Subsequent loads are cached and much faster.
If the indicator never disappears, the HubSpot back end is likely returning an error the connector swallowed silently. Check Export History for the timing — if you see a 5xx around the time you triggered the load, that’s the actual failure.
Trial and quota #
"Trial plan: you have reached the maximum of 2 data sources" #
Your tenant is on the trial plan and already has 2 data sources. The Create and Clone actions are blocked.
Fix: delete a data source to free a slot, or upgrade your Power BI Connector for HubSpot subscription. See Subscription plans and trial limits.
Still stuck? #
Open the in-app help dialog (question-mark icon in the toolbar) and follow the Support section. The link there points to the right channel for your tenant.
