Metrica
Metrica
✕
  • Home
  • Products
    • Power BI Connector for Salesforce
    • Power BI Connector for SAP
  • Resources
    • Blog
    • Trust Center
Explore Products

Home - Metrica Docs - What’s the difference between a HubSpot Private App and OAuth connection?

Getting Started

  • Welcome
  • Installation Guide
  • Quickstart — from Zero to a Power BI Report
  • Explore Power BI Connector for HubSpot

User Guide

  • Create a Data Source
  • Connect Power BI Desktop
  • Schedule Refresh in Power BI Service
  • Edit a Data Source
  • Filter Rows
  • Preview Data
  • Preview the Associations Map
  • Clone a Data Source
  • Share a Data Source
  • See What’s Been Shared with You
  • Transfer Data Source Ownership
  • History
  • Explore Associations
  • Browse and Search the Data Sources List
  • Delete a Data Source

Admin Guide

  • Create an Access Token
  • Manage Access Tokens
  • Configure the Token Expiry Policy
  • Application Permissions Setup

FAQ & Troubleshooting

  • Troubleshooting
  • How many data sources can I create?
  • Why is the URL of every data source different?
  • Can I change the data source URL after creation?
  • Can I use the OData URL outside Power BI?
  • Why do I get 401 from the Power BI service after a successful Desktop refresh?
  • Why does the connector limit me to 5 active tokens?
  • What happens if I lose a token?
  • Can a tenant admin see the value of my access tokens?
  • Will the recipient see my access token if I share with them?
  • Can I share a data source with a user from a different tenant?
  • What happens to a shared data source if I leave the company?
  • How is Preview Associations Map different from Data Relationships?
  • Why does the Basic filter editor sometimes disable itself?
  • Why doesn’t the connector cache HubSpot data?
  • Why are my HubSpot datetimes showing in UTC?
  • What happens if I delete or archive a HubSpot property?
  • Why are HubSpot API limits showing up in my refresh errors?
  • What’s the difference between a HubSpot Private App and OAuth connection?

Support

  • Contact Support
  • Pricing and Licensing
  • Subscription Plans and Trial Limits
  • Data Security and Privacy Statement
  • End-User License Agreement
  • Service Level Agreement (SLA)
View Categories
  • Metrica Docs
  • Power BI Connector for HubSpot Documentation
  • FAQ & Troubleshooting

What’s the difference between a HubSpot Private App and OAuth connection?

1 min read

HubSpot offers two ways for external apps to read your data: a Private App (a token you mint manually in HubSpot’s Integration settings) and an OAuth app (a third-party app you install from the Marketplace, which then requests OAuth scopes).

Power BI Connector for HubSpot is an OAuth app. When your HubSpot Super Admin installs it from the Marketplace, HubSpot walks them through approving the OAuth scopes the connector needs. There is no Private App token to manage on your side — the OAuth grant covers the connector’s read access to HubSpot data.

What about the access tokens I create in the connector? #

The access tokens you mint in the connector’s Access Tokens page are not HubSpot tokens. They’re connector-side bearer tokens used by Power BI to authenticate against the connector’s OData URL. Power BI sends the connector token; the connector then uses its own OAuth grant to read HubSpot.

Two layers of credentials:

  1. OAuth grant — HubSpot Marketplace install. One per portal. Managed by the HubSpot Super Admin.
  2. Connector access token — minted per user in the connector. Used by Power BI Desktop and Power BI service. Multiple per user are OK.
i

If you uninstall the connector from HubSpot, the OAuth grant is revoked — every connector access token stops working immediately, even though the tokens themselves are still listed in the connector. Re-installing the connector restores the OAuth grant but does not revive old tokens; mint new ones.

Updated on May 20, 2026

Share This Article :

  • Facebook
  • X
  • LinkedIn
  • Pinterest
Why are HubSpot API limits showing up in my refresh errors?Troubleshooting
Table of Contents
  • What about the access tokens I create in the connector?
Metrica
Explore Products
Products
  • Power BI Connector for Salesforce
  • Power BI Connector for SAP
Resources
  • Blog
  • Trust Center

Metrica Software builds enterprise data connectors that provide analytics platforms with direct access to complex business systems such as SAP and Salesforce.

The focus is on predictable behavior, controlled access, and long-term operation in production environments.

© 2026. All rights reserved.

Privacy Policy

Terms of Use

    Book a Demo







    Secure & private form

    1-2 min

    ×

      Contact Sales








      Secure & private form

      1-2 min

      ×