Product workflow2 min readKeep one real product question in mind as you read.
A useful way through

Start with one real question and leave with a next step.

Start with the question in front of you, then use the guide to make the next decision easier.

Try saying

“I am trying to make this decision. What should I look at first?”

Start with context

Bring the smallest useful example.

Look for the signal

Separate what is known from what is assumed.

Take one step

Choose an action you can review.

HubSpot Integration

What this connection is for

Bring contacts, deals, tickets, and customer notes together so product decisions have the revenue context.

How your data reaches Specky

Specky pulls from HubSpot on a schedule. A sync runs when you open your workspace if the data is stale, and you can also start one by hand from the integration card.

Before you start

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

Setup

Open Settings → Integrations, find HubSpot, and click Connect. The form will tell you what to paste and where to find it.

How to create a Private App Access Token

  1. Go to your HubSpot account → Settings (gear icon)
  2. In the left sidebar, navigate to Integrations → Private Apps
  3. Click "Create a private app"
  4. Give it a name like Specky
  5. 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)
  6. 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

New HubSpot items appear in Discovery alongside your other sources. You can search them, ask questions about them, and cite them in product work without opening another tab.

Disconnecting HubSpot removes 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.

Ready to apply this?

Start with your own product and keep the first read grounded. You'll create an account before the guided result so it can be saved to your workspace.

Try the guided start