Skip to main content

Connecting your CRM to Uhubs

This article covers how the connection process works, the steps needed for Salesforce and HubSpot, and what happens after the connection is made.

Uhubs pulls live KPI data directly from your CRM so that pipeline, revenue, win rate, and attainment figures appear automatically inside Insights — no manual exports, no data wrangling before workshops.


How the process works

CRM integration is typically completed as part of onboarding, however you can complete this process yourself too.

What you'll need

Regardless of which CRM you use, the person completing the connection will need:

  • A Uhubs account with admin access

  • Admin or API-level access to your CRM (to log in and approve the Salesforce connection, or to create the HubSpot token below)

  • Your KPI calculations to hand — either a live report or written formulas


Connecting Salesforce

Salesforce connects in one click — you don't need a Connected App, Client ID, Client Secret or Instance URL.

Steps to connect

  1. Log into Uhubs and click Uhubs Connect in the left navigation.

  2. Select Salesforce from the list of available integrations.

  3. Click Connect. You'll be taken to Salesforce.

  4. Log in with your own Salesforce account. Once you're logged in, you'll be returned to Uhubs.

Tip: the connection is linked to the Salesforce user who sets it up. If that user is deactivated (for example, when someone leaves), you'll need to connect again — so where possible, use a shared admin or integration user.


Connecting HubSpot

Credentials required

HubSpot uses a Private App token for authentication. You will also set a source name to identify this connection inside Uhubs.

Field in Uhubs

What it is

Where to find it

Access Token

Private App token from HubSpot

HubSpot → Settings → Integrations → Private Apps

Source Name

A label for this connection in Uhubs

You choose this — e.g. HubSpot-Production

Steps to connect

  1. Log into Uhubs and click Uhubs Connect in the left navigation.

  2. Select HubSpot from the list of available integrations.

  3. Enter the Access Token and give the connection a Source Name.

  4. Click Save. Uhubs will confirm the connection is active.

Creating a HubSpot Private App

If one doesn't exist already:

  1. In HubSpot, go to Settings (gear icon) → Integrations → Private Apps.

  2. Click Create a private app.

  3. Give it a name (e.g. Uhubs Integration) and, on the Scopes tab, enable CRM read scopes — at minimum: crm.objects.contacts.read, crm.objects.deals.read, and crm.objects.owners.read.

  4. Click Create app. HubSpot will display the Access Token — copy it immediately, as it won't be shown in full again.

  5. Use this token in Uhubs Connect.

If your HubSpot account is managed by a third party, ask them to create the Private App and share the token with you. You do not need to share your main HubSpot login credentials.


Reconnecting a broken connection

If a CRM connection stops working (for example, because the Salesforce user who set it up has been deactivated), the Salesforce, HubSpot or Dynamics page in Uhubs Connect shows a red needs reconnecting card with the reason. Click Reconnect to fix it.

Only admins can connect or reconnect a CRM in Uhubs.


Need help?

Use the in-platform chat and someone from the Uhubs team will help you get connected.

Did this answer your question?