---
name: hubspot-linkedin-integration
description: Connect HubSpot and LinkedIn Sales Navigator: what syncs, which editions carry it, the setup order, and the failures to expect. Covers contacts, companies, deals, activities. Use when the user wants to set up, audit or troubleshoot HubSpot and LinkedIn together, or asks why data is not moving between them.
---

# HubSpot and LinkedIn Sales Navigator

> Generated from https://www.reversecontact.com/integrations-hub/hubspot-integrations/hubspot-linkedin-integration
> Every tier requirement, sync direction and limit below was read from the vendors' own documentation on 2026-10-11.
> Vendors change these without notice. Re-check anything load-bearing before you rely on it.

**What you have to buy first:** Sales Hub Professional or Enterprise, plus Sales Navigator Advanced Plus

**What moves:** contacts, companies, deals, activities, both ways.
**How it is built:** native, marketplace app. **Effort:** hours.

## The short version

The integration is good and the gate is expensive. CRM Sync writes Sales Navigator activity back to HubSpot, creates and updates contacts from Sales Navigator, and matches your records so reps can filter searches by what is already in the CRM. All of that needs Advanced Plus, which is the quoted edition rather than the one on the pricing page. If your reps are on Advanced, what you have is an embedded profile card, and the honest description of that is a convenience feature rather than a sync.

## Check the plan before anything else

Rows: HubSpot edition. Columns: Sales Navigator edition. Most of the reports that this integration is broken are a pairing from this grid that was never going to work.

| HubSpot edition | Core | Advanced | Advanced Plus |
|---|---|---|---|
| Free or Starter | Nothing | Nothing | Nothing |
| Sales Hub Professional | Nothing | Profile card only | Full CRM Sync |
| Sales Hub Enterprise | Nothing | Profile card only | Full CRM Sync |

- **Nothing.** Neither half. Embedded Profiles needs Sales Hub Professional or Enterprise, so no LinkedIn edition unlocks anything below that.
- **Profile card only.** The embedded Sales Navigator card inside the HubSpot record, and nothing that writes. This is the combination most teams are on when they say the integration is disappointing.
- **Full CRM Sync.** Contacts, companies, deals and owners syncing, activity writeback, contact creation and CRM-aware search filters.

Counted off that grid, of nine pairings: five give you nothing, two give you profile card only, two give you full CRM Sync.

The combination people describe in sales conversations is the bottom-right corner. If you are on one of the pairings that returns a profile card, the upgrade is a contract conversation rather than a settings change, and it is worth pricing across the whole seat count before you spend an afternoon in Connected Apps.

## What actually syncs

Direction is written from HubSpot's point of view: out means out of HubSpot, in means into it.

| What | Direction | What that means in practice |
|---|---|---|
| Contacts and Leads | Two-way sync | HubSpot contacts import into Sales Navigator lists; Sales Navigator can create and update HubSpot contacts. |
| Companies and Accounts | Two-way sync | Matched so account pages show CRM context and searches can filter on it. |
| Deals and Opportunities | Two-way sync | Open pipeline is visible inside Sales Navigator and feeds revenue attribution reporting. |
| Owners | One way, in | HubSpot only. Owner data goes across so book ownership is respected; nothing comes back. |
| Sales Navigator activity | One way, out | InMails, messages and notes log to HubSpot as activities. This is the half most teams are buying. |

## Which field lands where

HubSpot and LinkedIn use different words for the same record, and the mapping between them is fixed. Every supported field syncs or none of them does, so this table is the contract rather than a default you can tune.

| In HubSpot | In LinkedIn | What to know about the match |
|---|---|---|
| Contacts | Leads | Matched automatically, and CRM Badges in Sales Navigator show whether a lead already exists in HubSpot. An unmatched profile can create a HubSpot contact, but only if you supply an email address. |
| Companies | Accounts | Badged the same way, and a wrong match can be corrected from the account page rather than in HubSpot. |
| Deals | Opportunities | Open pipeline becomes visible inside Sales Navigator, which is also what feeds the revenue attribution report. |
| Owners | No LinkedIn equivalent | Owner data crosses so Sales Navigator knows who holds a record, and it connects HubSpot users to LinkedIn users for verification. Nothing comes back. |

### What a Sales Navigator action looks like once it lands in HubSpot

| The action | How it reads on the record |
|---|---|
| InMail | InMails sent and received from Sales Navigator, followed by the subject line the sender wrote |
| Message sent | Messages sent and received from Sales Navigator |
| Smart Link view | Smart Link View from Sales Navigator |
| Call logged | Phone Call from Sales Navigator |
| Note on a lead or contact | Notes from Sales Navigator |
| Connection request | Connection requests sent from Sales Navigator |

**What does not cross:**

- Individual mappings. There is no per-field switch, so a HubSpot property you would rather keep in HubSpot cannot be held back.
- Anything that happened before go-live. Only new and updated data syncs once the sync is on.
- The ROI report. LinkedIn gates it behind your account representative rather than a settings page.

## Connect it, in this order

**Who has to do it:** A HubSpot Super Admin and a Sales Navigator contract admin, which in most companies is two people on two teams.
**How long:** About half an hour for the admins, then one authentication per rep.

### 1. Price both editions before you touch a settings page

*Where:* Contracts

LinkedIn documents two requirements for CRM Sync: Sales Navigator Advanced Plus, and a HubSpot Sales Hub Professional licence or higher. Advanced Plus is quoted rather than listed, so get the number across your whole seat count while this is still a decision.

### 2. Install the Sales Navigator app for every user first

*Where:* HubSpot App Marketplace

Embedded Profiles is a per-user install, and LinkedIn recommends doing it before CRM Sync so the embedded experiences arrive complete. This half runs on Advanced as well as Advanced Plus, which is why some teams already have it and think the sync is next.

### 3. Disconnect Business Manager if it is already paired

*Where:* HubSpot: Settings, Integrations, Connected Apps

An existing LinkedIn Business Manager connection blocks the Sales Navigator pairing. The documented order is disconnect, sync, then reconnect Business Manager afterwards. Skip it and the pairing simply will not complete.

### 4. Install LinkedIn CRM Sync and choose the environment

*Where:* HubSpot App Marketplace

Install the app, click Connect to LinkedIn CRM Sync, sign in, and pick the contract if you sit on more than one. Then choose Production or Sandbox: one HubSpot account pairs with one Sales Navigator environment at a time, so a sandbox trial holds the slot your production pairing needs.

### 5. Start all four syncs

*Where:* HubSpot: Connected Apps, LinkedIn CRM Sync

Start all syncs covers contacts, companies, deals and owners in one click. Each object has a Configure, Limit and Organize view that says which records qualify and whether associations and deletions travel, and those are worth reading before you walk away from it.

### 6. Make every rep authenticate individually

*Where:* Sales Navigator: Settings, CRM Settings

Admin authentication does not cover writeback. Contact creation and activity writeback need each user to click Connect to CRM themselves, and a rep who never does it logs nothing while appearing to be set up.

### 7. Select LinkedIn in the activity filter

*Where:* HubSpot contact record

Writeback reaches the record and stays invisible until LinkedIn is ticked under Filter activity. A team that misses this reads a working sync as a failed install on day one.

None of the seven steps is difficult. The order is what costs time: two of them undo work if you take them late, and the per-rep authentication is the step that makes a correctly installed sync look broken for weeks.

## How to check it worked

- Open a HubSpot contact a rep has messaged on LinkedIn since go-live, tick LinkedIn under Filter activity, and confirm the InMail or message appears in the timeline.
- In Sales Navigator, search a company you know is in HubSpot and confirm the CRM badge marks the existing records.
- Have one rep who is not an admin send an InMail and check it lands. That is the test of per-user authentication, and an admin-only test will pass while every rep logs nothing.
- Create a contact from Sales Navigator for somebody who is already in HubSpot under a different email, then check whether you have one record or two. That tells you how much duplicate control you need before the reps start.

## When it goes wrong

Each row is a symptom somebody reports, the documented reason, and the fix. Work down it before escalating to either vendor, because most of these are configuration.

| Symptom | Why it happens | What to do |
|---|---|---|
| The Sales Navigator card does not appear on the contact record | Either the seat is on Sales Navigator Core, or the per-user app install never happened. Embedded Profiles needs Advanced or Advanced Plus and an install by each user, not just by the admin. | Check the edition on the seat, then have that user install the LinkedIn Sales Navigator app from the HubSpot App Marketplace themselves. |
| InMails and messages are not reaching the timeline | LinkedIn is not selected in the activity filter. The writeback arrives on the record and the timeline hides it. | On the contact record, open Filter activity and tick LinkedIn. Check one rep who has definitely sent an InMail since go-live. |
| Writeback works for some reps and not others | Activity writeback and contact creation need each user to authenticate with the CRM individually. Admin authentication does not cover them. | Send the reps who are missing to Sales Navigator, Settings, CRM Settings, Connect to CRM. Confirm the admin has enabled writeback for the contract, because user authentication only appears once that is on. |
| A rep cannot update a HubSpot contact from Sales Navigator | Sales Navigator respects HubSpot permissions. Without read and write access to that record in the CRM, the update is refused on the LinkedIn side. | Fix the permission in HubSpot rather than in Sales Navigator. This is also the first thing to check when a correctly licensed Advanced Plus install appears to do nothing. |
| The pairing will not complete | A LinkedIn Business Manager connection is already in place, or the HubSpot account is paired to a different Sales Navigator environment. Only one pairing exists at a time. | Disconnect Business Manager, complete the Sales Navigator sync, then reconnect it. If a sandbox was paired for testing, release it before pairing production. |
| The CRM filled up with duplicate contacts | Contact creation from Sales Navigator writes a new record whenever no match is found, and a rep working a list will not stop to look for the match. | Require an email address and an account association on creation, keep HubSpot duplicate management running, and train reps to use Find CRM record before Create new CRM record. This is the failure mode practitioners raise most often. |
| Two years of LinkedIn history is missing | There is no backfill. Only new and updated data syncs after go-live. | Uninstalling and reinstalling the app resets the sync and sends every record again, which is documented rather than a support trick. Decide this before the first report, not after. |

## What breaks, from the vendors' own docs

- **It will not backfill.** Only new and updated data syncs once the sync is turned on. Getting history across means uninstalling and reinstalling the app, which is a documented procedure rather than a support workaround. Plan the switch-on date, because everything before it stays where it is.
- **Field mapping is all or nothing.** Individual field mappings cannot be customised. Every supported field syncs, or none of them do. If you hold a property in HubSpot that should not leave it, this integration is not the thing that keeps it in.
- **Advanced is not Advanced Plus.** The embedded Sales Navigator card runs on Advanced. Activity writeback, contact creation and record matching do not. This is the single most common surprise on this pair, and it is a contract conversation rather than a settings one.
- **Install needs two admins.** Super Admin or App Marketplace access permissions in HubSpot, plus admin rights on the Sales Navigator contract. In most companies those are two different people on two different teams.

## The APIs, if you are building around it instead

### HubSpot

- **Base:** `https://api.hubapi.com`
- **Auth:** `Authorization: Bearer <private-app-token>` for a private app, or OAuth for a marketplace app. Full CRM API access is on every tier including Free.

| Call | Request | What it does |
|---|---|---|
| `PATCH /crm/v3/objects/contacts/{contactId}` | `{ "properties": { "rc_title": "VP Sales" } }` | Update a contact. Send only the properties you own. |
| `POST /crm/v3/objects/contacts/search` | `{ "filterGroups": [...], "properties": [...] }` | Find records by property. Use this to pull the slice that is missing a field. |
| `POST /crm/v3/objects/contacts/batch/update` | `{ "inputs": [ { "id": "...", "properties": {...} } ] }` | Batch of up to 100. Prefer this over per-record PATCH at volume: it is one request against the rate limit. |

**Rules that will cost you time if you skip them:**

- **Rate limits.** A private app gets 190 requests per 10 seconds on Professional and Enterprise, 100 on Free and Starter. Daily caps are 250,000 / 625,000 / 1,000,000 calls **per account, shared across every app**. A public OAuth marketplace app is capped at 110 per 10 seconds per installing account.
- **Calling an external API from a workflow needs Data Hub Professional or Enterprise.** Both the webhook action and the custom code action live in that hub, not in Sales Hub. Check this before designing an in-HubSpot build.
- **Custom code actions get 20 seconds and 128 MB.** Combined length of all workflow secrets is capped at 1,000 characters. Secrets are read with `process.env.NAME`.
- **Workflows:** up to 50 simple on Starter, up to 300 fully customisable on Professional.
- **Never write to a property a human maintains.** Use prefixed properties (`rc_*`) and promote with a separate workflow only where the human field is empty.

**HubSpot custom code action (Node 20):**

```javascript
// Input field: email   Output fields: rc_status, rc_title, rc_company, rc_headcount
// Secret: RC_API_KEY
const axios = require('axios');

exports.main = async (event, callback) => {
  const email = event.inputFields['email'];
  const res = await axios.post(
    'https://api.reversecontact.com/v2/enrich/persons',
    { email },
    { headers: { Authorization: `Bearer ${process.env.RC_API_KEY}` } }
  );

  const person = res.data?.data?.person;
  const company = res.data?.data?.company;

  // null means "not found", not "try harder". Write nothing and flag it.
  if (!person) return callback({ outputFields: { rc_status: 'no_match' } });

  callback({ outputFields: {
    rc_status:    'matched',
    rc_title:     person.currentPosition?.title || '',
    rc_company:   company?.name || '',
    rc_headcount: company?.employeeCount || 0
  }});
};
```

Docs: https://developers.hubspot.com/docs/api/overview

### LinkedIn Sales Navigator

- **Base:** `No public API for this workflow`
- **Auth:** CRM Sync is installed as an app, not called as an API.

**Rules that will cost you time if you skip them:**

- **CRM Sync requires Sales Navigator Advanced Plus**, not Advanced. The embedded profile card runs on Advanced and syncs nothing.
- **It does not backfill.** Only new and updated data syncs after switch-on; history needs an uninstall and reinstall.
- **Field mappings cannot be customised.** Every supported field syncs or none do.
- **Read your contract before extracting anything from search results.** The constraint is contractual rather than technical, so it does not announce itself when you cross it. An agent must not automate scraping here.

Docs: https://knowledge.hubspot.com/integrations/connect-hubspot-and-linkedin-crm-sync

## Filling the record this integration moves

The integration above moves a record between two systems. Neither of them creates what is in it, so a sync that works perfectly still carries whatever gaps the record arrived with. Reverse Contact resolves an email, a domain or a profile URL into a verified people and company record through one API, and returns null with a confidence score rather than a guess.

### Reverse Contact

- **Base:** `https://api.reversecontact.com/v2`
- **Auth:** `Authorization: Bearer rc_your_api_key`. Keys are created in Workspace > API Keys.

| Call | Request | What it does |
|---|---|---|
| `POST /v2/enrich/persons` | `{ "email": "j.okafor@northwind.io" }` | Resolve a person from an email, a name plus company, or a profile URL. Cached resolution, returns in the response. |
| `POST /v2/enrich/companies` | `{ "domain": "northwind.io" }` | Resolve a company from a domain or a name. |
| `POST /v2/fetch/persons` | `{ "linkedInUrl": "..." }` | Standard profile lookup from the database. |
| `POST /v2/fetch/persons/live` | `{ "linkedInUrl": "..." }` | Live on-demand resolution. ASYNCHRONOUS: returns a webhookId to poll, not a record. |
| `POST /v2/search/people` | `{ "filters": { "currentCompanyDomain": "northwind.io" } }` | Filtered people search. 1 credit a profile delivered, and /v2/search/people/count is free. It replaced /v2/search/persons, which returns 410 Gone since 13 October 2026. |
| `POST /v2/search/organizations` | `{ "filters": { "companyDomain": "northwind.io" } }` | Filtered company search. A domain can also go straight to a company through POST /v2/enrich/companies, or through the enrich_company MCP tool since November 2026. |
| `POST /v2/contact/email` | `{ "linkedInUrl": "..." }` | Find an email. ASYNCHRONOUS: returns a taskId to poll. 3 credits for a professional address, 5 for a personal one, 8 for both, refunded when neither is found. |
| `GET /v2/webhooks/:webhookId` | - | Poll an async job until status is "succeeded". Polling is free and does not count against the rate limit. |

Response shape:

```json
{
  "success": true,
  "data": {
    "person": {
      "fullName": "Jane Okafor",
      "headline": "VP Sales at Northwind",
      "location": "London, United Kingdom",
      "linkedInUrl": "https://linkedin.com/in/...",
      "currentPosition": { "title": "VP Sales", "companyName": "Northwind", "startDate": "2023-04" },
      "emails": [], "experience": [], "education": [], "skills": []
    },
    "company": { "name": "Northwind", "domain": "northwind.io",
                 "industry": "Software Development", "employeeCount": 220 }
  },
  "error": null,
  "metadata": { "requestId": "req_...", "executionTimeMs": 480, "updatedAt": "2026-09-01T..." },
  "quotas": { "creditsConsumed": 1, "workspace": { "credits": { "total": 10000, "used": 4521, "left": 5479 } } }
}
```

**Rules that will cost you time if you skip them:**

- A miss returns **null**, not a best guess. Every response carries a confidence score, and you can raise the precision threshold on the request. Branch on it: do not treat a low-confidence answer as a match.
- Use the cached endpoints anywhere that must answer inside one HTTP request. The `/live` endpoints return a task and need polling.
- `quotas.workspace.credits.left` is on every response. Log it, or you will find out about the balance from a 402.
- Credit costs per call are published and a dollar rate per lookup is not: 2 credits for a reverse lookup from an email, 1 for a cached profile lookup, 2 for a live refresh, 3 for a business email and 20 for a direct phone number, with the last two charged only when one is found. Checks and the search count endpoint are free. Credit packs expire after 3 months. Do not hard-code a dollar cost assumption.

**MCP server:** `https://api.reversecontact.com/mcp`

- Auth: OAuth 2.1 where the client supports it, otherwise `Authorization: Bearer rc_your_api_key`.
- Tools: `enrich_person`, `enrich_person_live`, `enrich_company`, `enrich_company_live`, `search_persons`, `search_companies`, `check_usage`, `check_task`
- Streamable HTTP, JSON-RPC 2.0. The `_live` tools return a task id that `check_task` polls.

Docs: https://docs.reversecontact.com/getting-started

## Sources

- HubSpot knowledge base: connect HubSpot and LinkedIn CRM Sync: https://knowledge.hubspot.com/integrations/connect-hubspot-and-linkedin-crm-sync
- LinkedIn: CRM Sync for HubSpot enablement guide (PDF): https://www.linkedin.com/help/sales-navigator/answer/a8037044
- 14 practitioner threads read on 2026-10-11, summarised on the page: https://www.reversecontact.com/integrations-hub/hubspot-integrations/hubspot-linkedin-integration#reddit
- This pair, with the reasoning behind each step: https://www.reversecontact.com/integrations-hub/hubspot-integrations/hubspot-linkedin-integration

---

*Published by Reverse Contact, which appears in this directory as a data provider.
No other vendor pays for placement. Where a vendor publishes no public figure, this file says so
rather than estimating. Reverse Contact costs are stated in credits, which it publishes; no dollar
rate per lookup appears here, because none is published and dividing a pack price is not their number.*
