The HubSpot card says Needs reconnect — why?

An admin revoked the OAuth grant in HubSpot, or the token failed `invalid_grant` on a refresh. Click Reconnect — it takes ten seconds and re-issues fresh tokens.

My HubSpot deal stage isn't in the filter dropdown.

Re-run discovery from the HubSpot card in Settings. Discovery is a snapshot — new stages added in HubSpot don't appear in Callmine's filter UI until you re-run.

Analysis shows deal context for some calls but not others.

Gong only embeds HubSpot context on calls that were logged against a deal in HubSpot. Calls without a deal association show as enriched=false in the report diagnostics. This is a HubSpot data issue, not a Callmine fetch issue.

My private app token is rejected on save.

Verify all four read-only scopes are granted on the HubSpot private app. Missing `crm.schemas.deals.read` is the most common cause — pipeline metadata won't load without it.

Why isn't my HubSpot integration working?

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

Diagnose a broken HubSpot integration in five steps: check connection status, verify scopes, re-run discovery, confirm filters, validate calls.

TL;DR

Most HubSpot integration failures fall into four buckets: a revoked credential, missing scopes, a stale discovery snapshot, or filters that exclude every call. Walk through the five steps below in order — the first mismatch you find is almost always the cause.

Steps

01Open /settings and check the HubSpot card. If it shows Needs reconnect, click Reconnect. OAuth invalid_grant and an expired private app token both surface here.
02Verify the four read-only scopes are still granted. For OAuth, open HubSpot's connected-apps page and check Callmine's row. For a private app, open the app in HubSpot and confirm all four scopes are present.
03If filters are showing old labels or you don't see a new pipeline stage you just added, re-run discovery from the HubSpot card. Discovery is a snapshot — new HubSpot values aren't visible until the next run.
04If an analysis returned fewer enriched calls than expected, open the report's diagnostics panel. It shows pre-filter and post-filter call counts plus per-call enrichment status. Calls without a HubSpot deal association show as un-enriched — this is expected and not a Callmine bug.
05If the connection is healthy but a run returned zero calls, run a Preview from /new with HubSpot filters cleared. If Preview now shows calls, the filter combination was excluding everything — typically a deal-stage mismatch after a HubSpot rename.

Common scenarios

·Renamed a pipeline stage in HubSpot. Re-run discovery, then re-apply the filter using the new label. Callmine doesn't auto-map old stage IDs to renamed labels.
·Removed a sales rep in HubSpot. The owner won't appear in the Sales rep filter after the next discovery run. Existing reports still reference them by name.
·OAuth grant revoked by another admin. Reconnect from your own account so the new tokens are bound to a live HubSpot user.

Still stuck

Email hello@callmine.ai and include the /runs/<jobId> URL of the failed run. The diagnostics panel tells us within seconds whether the issue is auth, scopes, or filter logic.