SpeckyDocs

HubSpot Integration

What it does

Import contacts, deals, tickets, and feedback from HubSpot CRM.

How your data reaches Specky

Specky pulls from HubSpot on a schedule. A sync runs when you open your workspace if the data has gone stale, and you can trigger one by hand from the integration card at any time.

What you'll need

  • Private App Access Token (Required) — Private app access token from your HubSpot developer settings.

    • Setup

    Go to Settings → Integrations, find HubSpot, and click Connect.

    How to create a Private App Access Token

  • Go to your HubSpot account → Settings (gear icon)
  • In the left sidebar, navigate to Integrations → Private Apps
  • Click "Create a private app"
  • Give it a name like Specky
  • Go to the Scopes tab and enable:
    • - crm.objects.contacts.read - crm.objects.deals.read - tickets.read (Service Hub) - crm.objects.feedback_submissions.read (optional)
  • Click "Create app" and copy the Access Token

    • Data synced

    DataUsed for

    ContactsCustomer context, account mapping DealsPipeline visibility, revenue signals TicketsSupport issues, bug reports, feature requests Feedback submissionsNPS, CSAT, customer sentiment

    How Specky uses HubSpot data

  • Product Graph: Contacts, deals, and tickets appear as graph nodes alongside Slack, Jira, etc.
  • PRD Generation: AI cites customer feedback and deal context when writing specs
  • Discovery Workbench: Surface support ticket patterns and deal blockers

    • After connecting

    Everything Specky pulls in from HubSpot shows up in Discovery alongside your other sources, and feeds synthesis, clustering, and the AI chat's answers about your product. You don't have to do anything with it directly — it's there so the rest of Specky has something to reason over.

    Disconnecting HubSpot removes both the connection and the signals it brought in.

    Troubleshooting

  • Connected, but nothing appears. Open the HubSpot card and run a sync by hand. If it errors, the card shows the reason.
  • "Upgrade to connect". Your plan caps how many integrations you can connect at once, and a few providers are Scale-only. Settings → Usage shows where you stand.
  • Credentials stopped working. Tokens expire and get revoked. Reconnect with a fresh one — your existing signals are kept.

    • See the HubSpot integration page for what it's for and the questions people usually ask first, or the Integrations Overview for how integrations work in general.