---
title: Connect Salesforce to Hublead
description: "Connecting Salesforce to Hublead takes two steps: a Salesforce admin installs Hublead in the org once, then each user connects their own account from the extension."
---

[Skip to content](https://knowledge.hublead.io/connect-salesforce-to-hublead#main-content)

[![hublead logo](https://knowledge.hublead.io/hs-fs/hubfs/hublead%20logo.png?width=100&height=21&name=hublead%20logo.png)](https://www.hublead.io/)

- [Home](https://knowledge.hublead.io/)
- Getting Started
  
  Show submenu for Getting Started

    - [How HubSpot and Hublead connect](https://knowledge.hublead.io/how-hubspot-and-hublead-connect-how-it-works)
    - [Import contacts & companies](https://knowledge.hublead.io/en/import-contacts-companies)
    - [Sync Conversations](https://knowledge.hublead.io/en/import-linkedin-conversations-to-hubspot)
    - [LinkedIn Invitations](https://knowledge.hublead.io/en/import-linkedin-invitations)
- The Core Workflows
  
  Show submenu for The Core Workflows

    - HubSpot
      
      Show submenu for HubSpot

          - [How to trigger LinkedIn Workflow?](https://knowledge.hublead.io/how-to-trigger-linkedin-workflow)
          - [Leverage LinkedIn data in HubSpot](https://knowledge.hublead.io/en/leverage-linkedin-data-in-hubspot)
    - Chrome Extension
      
      Show submenu for Chrome Extension

          - [Export contacts from Sales Navigator to HubSpot using Hublead](https://knowledge.hublead.io/export-contacts-from-sales-navigator-to-hubspot-using-hublead)
          - [LinkedIn Message Templates](https://knowledge.hublead.io/linkedin-message-templates-two-core-use-cases-connection-requests-ongoing-conversations)
    - Data Enrichment
      
      Show submenu for Data Enrichment

          - [Connect Data Enrichment Tools to Hublead](https://knowledge.hublead.io/en/connect-data-enrichment-tools-to-hublead)
- [Dashboard & Settings](https://knowledge.hublead.io/dashboard-settings)
  
  Show submenu for Dashboard & Settings

    - Seats / Team / workspace administration
      
      Show submenu for Seats / Team / workspace administration

          - [How to Set Up Your Team](https://knowledge.hublead.io/en/how-to-set-up-your-team)
          - [Hublead subscription, plans, and seats](https://knowledge.hublead.io/hublead-subscription-plans-and-seats-licenses)
    - Billing
      
      Show submenu for Billing

          - [Hublead billing & subscriptions: trials, upgrades, downgrades & invoices](https://knowledge.hublead.io/hublead-billing-subscriptions-trials-upgrades-downgrades-invoices)
    - Reporting
      
      Show submenu for Reporting

          - [Funnel vs Activities report: how Hublead calculates the numbers](https://knowledge.hublead.io/funnel-vs-activities-report-how-hublead-calculates-the-numbers)
- [Troubleshooting](https://knowledge.hublead.io/troubleshooting-known-issues)
  
  Show submenu for Troubleshooting

    - [How to Fix the “An email is required to create this contact” Error](https://knowledge.hublead.io/how-to-fix-the-an-email-is-required-to-create-this-contact-error)
    - [How to deal with "Unexpected error: Cannot convert undefined or null to object"](https://knowledge.hublead.io/how-to-deal-with-unexpected-error-cannot-convert-undefined-or-null-to-object)
    - [Multiple HubSpot users sharing the same LinkedIn account](https://knowledge.hublead.io/multiple-hubspot-users-sharing-the-same-linkedin-account)
    - [Troubleshoot LinkedIn invitations not showing in HubSpot](https://knowledge.hublead.io/troubleshoot-linkedin-invitations-not-showing-in-hubspot)
    - [Trouble connecting Hublead with HubSpot](https://knowledge.hublead.io/trouble-connecting-hublead-with-hubspot)
    - [Trouble connecting with HubSpot](https://knowledge.hublead.io/en/trouble-connecting)
    - [How to report a bug from the Hublead Chrome extension](https://knowledge.hublead.io/how-to-report-a-bug-from-the-hublead-chrome-extension)

Open main navigation

Close main navigation

- [Home](https://knowledge.hublead.io/)
- Getting Started
  
  Show submenu for Getting Started

    - [How HubSpot and Hublead connect](https://knowledge.hublead.io/how-hubspot-and-hublead-connect-how-it-works)
    - [Import contacts & companies](https://knowledge.hublead.io/en/import-contacts-companies)
    - [Sync Conversations](https://knowledge.hublead.io/en/import-linkedin-conversations-to-hubspot)
    - [LinkedIn Invitations](https://knowledge.hublead.io/en/import-linkedin-invitations)
- The Core Workflows
  
  Show submenu for The Core Workflows

    - HubSpot
      
      Show submenu for HubSpot

          - [How to trigger LinkedIn Workflow?](https://knowledge.hublead.io/how-to-trigger-linkedin-workflow)
          - [Leverage LinkedIn data in HubSpot](https://knowledge.hublead.io/en/leverage-linkedin-data-in-hubspot)
    - Chrome Extension
      
      Show submenu for Chrome Extension

          - [Export contacts from Sales Navigator to HubSpot using Hublead](https://knowledge.hublead.io/export-contacts-from-sales-navigator-to-hubspot-using-hublead)
          - [LinkedIn Message Templates](https://knowledge.hublead.io/linkedin-message-templates-two-core-use-cases-connection-requests-ongoing-conversations)
    - Data Enrichment
      
      Show submenu for Data Enrichment

          - [Connect Data Enrichment Tools to Hublead](https://knowledge.hublead.io/en/connect-data-enrichment-tools-to-hublead)
- [Dashboard & Settings](https://knowledge.hublead.io/dashboard-settings)
  
  Show submenu for Dashboard & Settings

    - Seats / Team / workspace administration
      
      Show submenu for Seats / Team / workspace administration

          - [How to Set Up Your Team](https://knowledge.hublead.io/en/how-to-set-up-your-team)
          - [Hublead subscription, plans, and seats](https://knowledge.hublead.io/hublead-subscription-plans-and-seats-licenses)
    - Billing
      
      Show submenu for Billing

          - [Hublead billing & subscriptions: trials, upgrades, downgrades & invoices](https://knowledge.hublead.io/hublead-billing-subscriptions-trials-upgrades-downgrades-invoices)
    - Reporting
      
      Show submenu for Reporting

          - [Funnel vs Activities report: how Hublead calculates the numbers](https://knowledge.hublead.io/funnel-vs-activities-report-how-hublead-calculates-the-numbers)
- [Troubleshooting](https://knowledge.hublead.io/troubleshooting-known-issues)
  
  Show submenu for Troubleshooting

    - [How to Fix the “An email is required to create this contact” Error](https://knowledge.hublead.io/how-to-fix-the-an-email-is-required-to-create-this-contact-error)
    - [How to deal with "Unexpected error: Cannot convert undefined or null to object"](https://knowledge.hublead.io/how-to-deal-with-unexpected-error-cannot-convert-undefined-or-null-to-object)
    - [Multiple HubSpot users sharing the same LinkedIn account](https://knowledge.hublead.io/multiple-hubspot-users-sharing-the-same-linkedin-account)
    - [Troubleshoot LinkedIn invitations not showing in HubSpot](https://knowledge.hublead.io/troubleshoot-linkedin-invitations-not-showing-in-hubspot)
    - [Trouble connecting Hublead with HubSpot](https://knowledge.hublead.io/trouble-connecting-hublead-with-hubspot)
    - [Trouble connecting with HubSpot](https://knowledge.hublead.io/en/trouble-connecting)
    - [How to report a bug from the Hublead Chrome extension](https://knowledge.hublead.io/how-to-report-a-bug-from-the-hublead-chrome-extension)
- [Go to hublead.io](https://www.hublead.io/)

[Go to hublead.io](https://www.hublead.io/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Hublead Help Center](https://knowledge.hublead.io/?hsLang=en)
2. [Troubleshooting & known issues](https://knowledge.hublead.io/troubleshooting-known-issues?hsLang=en)

August 13, 2026

# Connect Salesforce to Hublead

Connecting Salesforce to Hublead takes two steps, in this order: a Salesforce **administrator installs Hublead in your org once**, then **each user connects their own Salesforce account** from the extension. If your connection fails on the first try, the org install is almost always the missing piece.

### The two steps, in order

- **Once per org, by an administrator:** Hublead has to be installed as a connected app in your Salesforce org.
- **Once per user:** each person clicks **Connect Salesforce** in the extension, logs in, and authorizes the connection.

Salesforce blocks standard users from authorizing a connected app that has not been installed in their org. Administrators are exempt from that rule, so **an admin connecting successfully is not proof that your org is set up**. Test with a sales user.

### Connect your own Salesforce account

1. Install the Hublead Chrome extension: go to [hublead.io](https://www.hublead.io), click **Try for free**, then **Download our extension**, then **Add to Chrome**. Chrome opens LinkedIn for you.
2. On LinkedIn, open the Hublead panel.
3. Click **Connect Salesforce**.
4. Log in to Salesforce and authorize the connection.
5. You land back in Hublead. Open any LinkedIn profile and the panel now shows your Salesforce data. It works on LinkedIn Sales Navigator too.

If you get an error page instead, your admin needs to complete the org install below.

### Install Hublead in your Salesforce org (administrator)

These steps are done once per org, by a Salesforce administrator, and take about five minutes. Sales users cannot do them, they do not have the required permission.

#### Step 1 – Trigger one connection attempt

Hublead only appears in the Salesforce setup screens **after someone has tried to authorize it at least once**. This first attempt is expected to fail.

1. In the Hublead extension, click **Connect Salesforce** and complete the Salesforce login.
2. You land on an OAuth error page. That is normal, the attempt has registered the app in your org.

#### Step 2 – Install Hublead in the org

1. In Salesforce, open **Setup**.
2. In the **Quick Find** box, type `OAuth` and select **Connected Apps OAuth Usage**.
3. Find **Hublead** in the list.
4. Click **Install** on that row, then confirm.

Two pages look alike and are easy to confuse. **Connected Apps OAuth Usage** lists the apps users have *attempted* to use. **Manage Connected Apps** lists the apps that are *actually installed*. To check the install worked, open **Manage Connected Apps**, Hublead must appear there.

#### Step 3 – Give your users access

When installing, Salesforce asks how users are allowed to use the app. Pick the option that matches your security policy.

**Option A – Admin approved users are pre-authorized (more controlled).** Only the profiles and permission sets you designate can connect.

1. **Setup** → **Quick Find** → **Manage Connected Apps**.
2. Click **Hublead**, then **Manage**.
3. Use **Manage Profiles** or **Manage Permission Sets** to add the profiles of your sales users.

Users whose profile is not listed will get an `OAUTH_APPROVAL_ERROR_GENERIC` error.

**Option B – All users may self-authorize (simpler).** Anyone in the org can connect Hublead on their own, with no per-profile assignment. You set this on the same **Manage** screen.

#### Step 4 – Reconnect

Ask the user to click **Connect Salesforce** again in the extension. The connection now completes and lands back in Hublead.

### What the error message tells you

| Error on screen or in the URL | What it means | What to do |
| --- | --- | --- |
| `invalid_client` – `app must be installed into org` | Hublead is not installed in this org, and the user is not allowed to approve an uninstalled app. | Steps 1 and 2 above. |
| `OAUTH_APPROVAL_ERROR_GENERIC` | Hublead is installed, but this user's profile has not been granted access to it. | Step 3 above. |

### One thing worth doing right after connecting

Hublead matches a LinkedIn profile to your Salesforce records using a LinkedIn URL field, and most orgs already have their own. Go to [hublead.app](https://hublead.app), then **Settings** → **Field mapping**, and select the Salesforce field where you already store LinkedIn URLs. You can map other LinkedIn information to your own custom fields there as well. Two minutes here is what makes the matching accurate from day one.

- [Getting started](https://knowledge.hublead.io/getting-started?hsLang=en)
- [The Core Workflows](https://knowledge.hublead.io/the-core-workflows?hsLang=en#main-content)

    - [Data Enrichment](https://knowledge.hublead.io/the-core-workflows?hsLang=en#data-enrichment)
    - [Chrome Extension](https://knowledge.hublead.io/the-core-workflows?hsLang=en#chrome-extension)
    - [HubSpot](https://knowledge.hublead.io/the-core-workflows?hsLang=en#hubspot)
- [Dashboard & Settings](https://knowledge.hublead.io/dashboard-settings?hsLang=en#main-content)

    - [Reporting](https://knowledge.hublead.io/dashboard-settings?hsLang=en#reporting)
    - [Billing](https://knowledge.hublead.io/dashboard-settings?hsLang=en#billing)
    - [Seats / Team / workspace administration](https://knowledge.hublead.io/dashboard-settings?hsLang=en#seats-team-workspace-administration)
- [Troubleshooting & known issues](https://knowledge.hublead.io/troubleshooting-known-issues?hsLang=en)
- [General](https://knowledge.hublead.io/general?hsLang=en#main-content)

    - [Billing](https://knowledge.hublead.io/general?hsLang=en#billing)

[![hublead logo-1](https://knowledge.hublead.io/hs-fs/hubfs/hublead%20logo-1.png?width=400&height=86&name=hublead%20logo-1.png "hublead logo-1")](https://www.hublead.io/)

hublead.io Help Center

Copyright © 2025, Hublead