Skip to content
  • There are no suggestions because the search field is empty.

How HubSpot and Hublead connect

Discover how HubSpot and Hublead work together

What you’ll learn

In this article, you’ll understand:

  • What a Hub ID is and how to find it
  • How Hublead maps one Hublead organization to one HubSpot portal
  • Why some users may (or may not) appear in the Hublead dashboard
  • What happens if you connect Hublead to the wrong Hub ID
  • What changes when your HubSpot portal (Hub ID) changes

 

Core concept: 1 Hublead organization = 1 HubSpot portal (Hub ID)

Hublead works at the organization level, not at the individual user level.

  • Each HubSpot account ID (Hub ID) corresponds to one Hublead organization.
  • Hublead does not merge multiple HubSpot portals into one Hublead organization.

What is a Hub ID?

A Hub ID is the unique numeric identifier of your HubSpot portal—think of it as your HubSpot “account number.”

How to find your Hub ID in HubSpot

You can find your Hub ID in two common places:

  1. In the URL

    Example: https://app.hubspot.com/contacts/1234567/

    → 1234567 is the Hub ID

  2. In your HubSpot account menu

  • Click your profile picture (top-right)

  • Next to your account name, you’ll see something like: My Company (1234567)

    → that number is your Hub ID

What happens when you connect Hublead to HubSpot

When you first connect Hublead to HubSpot, Hublead detects the Hub ID and:

  • If it’s the first time Hublead sees that Hub ID → it creates a new Hublead organization
  • If that Hub ID already exists in Hublead → it adds you as a user in the existing organization

This is why the Hub ID selection is a key step: it determines which Hublead organization you join.

Example: same email, multiple HubSpot portals

Suppose alex@company.com has access to two HubSpot portals:

  • Hub ID 111
  • Hub ID 222

If Alex connects Hublead to Hub ID 111, Alex becomes a user in the Hublead organization for 111.

If Alex later connects Hublead to Hub ID 222, Alex becomes a user in a separate Hublead organization, with its own:

  • Users list
  • Seats / licenses
  • Subscription plan
  • Dashboard data

Why a user appears (or does not appear) in the Hublead dashboard

A user appears in the Hublead dashboard for a given HubSpot portal when they:

  1. Install the Hublead Chrome extension (or use the Hublead app entry flow)
  2. Log in
  3. Connect HubSpot and select the correct Hub ID

Hublead then:

  • Detects the Hub ID
  • Associates the user with the Hublead organization for that Hub ID
  • Lists them under Hublead Users

First troubleshooting step (most common issue)

If a user is not showing in your Hublead dashboard, verify:

Which HubSpot portal (Hub ID) did they connect to?

In most cases, they either:

  • connected the wrong Hub ID, or
  • did not complete the HubSpot connection step.

You can share this guideline for troubleshooting: Trouble connecting

What if our HubSpot portal changes?

Because Hublead is tied to your HubSpot portal ID, a change of Hub ID effectively means a new Hublead organization.

If you migrate to a new HubSpot portal:

  • Users, seats, and dashboards will be associated with the new Hub ID
  • You will typically need to:
    • contact support for migration guidance
    • connect Hublead to the new portal
    • have users connect again to the correct Hub ID
    • reconfigure seats and user access for the new organization

What if I want to change the email associated with my Hublead user?

Because Hublead mirrors HubSpot users, changing the email is handled by creating a new HubSpot user identity.

Recommended process:

  1. Create a new user in HubSpot with the new email

  2. Log out and log back in to both:

    • Hublead dashboard

    • Hublead Chrome extension

      using the new email

  3. In Hublead, remove the old user from the team list (HubSpot teams / user list)

This is the reliable method to align the Hublead user identity with the new email.

FAQ

Q: Why do I see some colleagues in HubSpot but not in Hublead?

Usually, because they haven’t connected Hublead to HubSpot yet, or they connected to a different Hub ID.

Q: Can Hublead merge data across multiple HubSpot portals?

No. Each HubSpot portal (Hub ID) maps to its own Hublead organization. Data and users are isolated per Hub ID.

Q: What is the Hub ID again?

It is the unique numeric ID of your HubSpot portal. You can find it in the HubSpot URL or next to the account name in the top-right account menu.