Skip to main content

​
Overview

The HubSpot integration allows you to search through HubSpot contacts, companies, and deals. It supports both and .

​
Authentication

The HubSpot integration can be set up as a personal connection or as a shared connection.

​
Personal connection (OAuth)

Each user connects their own HubSpot account through an OAuth flow, available in Hyperspell as a personal connection without any additional setup. During the OAuth flow, users select which HubSpot objects they want to give access to.

​
Shared connection

An app admin can instead register a single shared connection using a HubSpot Service Key. Its data is synced once and made available to everyone in your app — no per-user OAuth required. To create the Service Key:
  1. Navigate to https://app.hubspot.com, select Development in the side bar, and click Keys.
    Creating a HubSpot Service Key with the crm.objects contacts, companies, and deals read scopes
  2. Click Create Service Key.
  3. Add the following scopes:
    • crm.objects.contacts.read
    • crm.objects.companies.read
    • crm.objects.deals.read
  4. Click Create.
    Creating a HubSpot Service Key with the crm.objects contacts, companies, and deals read scopes
Then register the shared connection with the following field:
​
string
required
Your HubSpot Service Key.