Do I need to be a HubSpot super admin to connect?

You need a HubSpot user with permission to install OAuth apps on the portal. That's usually a super admin, but some HubSpot accounts delegate it. The exact requirement is set on the HubSpot side.

Which scopes does Callmine request?

Four read-only scopes: read deals, read pipelines (via the deals schema scope), read owners, and read companies. Callmine never requests write scopes — we never modify your HubSpot data.

Is OAuth or a private app token better?

OAuth is the default if your portal allows it: it refreshes automatically and a HubSpot super admin can revoke from the portal. Private-app tokens are useful when you don't want a marketplace app installed.

What happens if I revoke the OAuth grant from HubSpot?

Callmine sees `invalid_grant` on the next request and marks the integration as needing reconnect. Existing reports stay; new analyses run without HubSpot enrichment until you reconnect.

How do I connect HubSpot to Callmine via OAuth?

Integrations / HubSpot·May 31, 2026·1 min·By Callmine Team

Connect HubSpot to Callmine via OAuth in under a minute. Authorize from Settings, approve four read-only scopes, callback completes.

TL;DR

Open /settings, find the HubSpot card under Integrations, click Connect with OAuth, approve the four read-only scopes on HubSpot's consent screen, and the callback completes the connection. The flow takes under a minute.

Steps

01Sign in to Callmine and open /settings. Switch to the Integrations tab and find the HubSpot card.
02Click Connect with OAuth. Callmine redirects you to HubSpot's authorization page on the portal you're currently signed into.
03Review the four scopes Callmine requests. All four are read-only — Callmine never writes to your HubSpot data, only reads deal metadata, pipeline definitions, owners, and company records.
04Click Connect app. HubSpot issues access and refresh tokens, then redirects you back to Callmine.
05Callmine confirms the connection. The HubSpot card now shows Connected, and the next analysis you run will enrich calls with deal context.

What happens after you connect

The first thing Callmine does is run discovery on your HubSpot portal — catalogs deal stages, owners, industry and company-size enum values across the deals it can see. This powers the adaptive filter UI at /new, so when you build an analysis you pick from the real labels in your portal rather than guessing IDs.

Discovery runs idempotently, so you can re-run it from the HubSpot card whenever your HubSpot schema changes — new pipeline stages, renamed owners, an extended industry picker.

When to use OAuth vs a private app token

OAuth is right for most teams: tokens refresh automatically, and revoking from HubSpot's app dashboard takes effect immediately. A private app token is the right path when your portal doesn't allow marketplace apps, or when your security policy prefers a credential generated and held under your direct control. See How do I connect HubSpot with a private app token?.