Skip to main content

HubSpot integration

How to connect Lusha to HubSpot, configure field mapping, prevent duplicate records, and troubleshoot common issues.

Written by Hila
Updated this week

The HubSpot integration lets you push contacts revealed in Lusha directly into HubSpot as Contacts or Companies. This guide covers how to connect, configure field mapping, and prevent duplicate records.

πŸ’‘ Note: You must be both a Lusha Admin and a HubSpot Admin to set up the integration. Only Admins and Managers can edit integration settings.

Step 1: Connect HubSpot to Lusha

  1. Log in to your Lusha dashboard.

  2. Go to Settings β†’ Integrations and select HubSpot.

  3. Click Connect β€” you'll be taken to the HubSpot login page.

  4. Sign in to HubSpot. (If you're already logged in, this step is skipped.)

  5. Click Continue to field mapping.

Step 2: Configure field mapping

Field mapping tells Lusha which HubSpot fields to populate when you export. You can map fields for two record types: Contacts and Companies.

Each Lusha field maps to a HubSpot field. You can change any default mapping using the dropdown.

πŸ’‘ Note: By default, all contacts exported to HubSpot are owned by the HubSpot user who connected the integration.

Default field mapping

Contact

Lusha field

HubSpot field

Email 1

Email

Phone 1

Phone

Job title

Jobtitle

Last Name

Last Name

First Name

First Name

Seniority

Seniority

Phone 2

Mobilephone

Companies

Lusha field

HubSpot field

Company Name

Name

Company Phone

Phone

Domain

Domain

Company Street

Address

Company Country

Country

Website

Website

Description

Description

Company Founded

Founded_year

Employees

Number of employees

LinkedIn

Linkedin_company_page

For a full list of available Lusha fields, see Fields for field mapping and descriptions.

Step 3: Add predefined value fields (optional)

  1. Choose a record type (Contacts or Companies).

  2. Click + Add field and select Predefined Value.

  3. Select a HubSpot field and enter the fixed value.

  4. Click Save changes before switching tabs.

Step 4: Set up conditional field mapping (optional)

  1. In Field mapping, click Advanced next to Email 1 or Phone 1.

  2. Use the Map dropdown to define the condition and value.

  3. Click Apply, then Save changes.

Account export preferences

(Available for Admins only)

HubSpot exports are currently limited to the Contact record type. Admins can disable new contact creation, which restricts users to exporting only to existing HubSpot contacts.

  1. Go to Settings β†’ Integrations β†’ HubSpot β†’ Settings tab.

  2. Use the Contact toggle to enable or disable new record creation.

πŸ’‘ Note: This setting applies to all team members in your account.

HubSpot identifier (duplicate prevention)

The HubSpot identifier checks whether a contact or company already exists in HubSpot before exporting, preventing duplicate records and saving credits.

Go to Settings β†’ Integrations β†’ HubSpot β†’ HubSpot Identifier tab to configure the mapping.

Lusha matches contacts using these combinations:

  • First name + Last name + Company name, or

  • First name + Last name + Company domain, or

  • Email address

For companies, matching uses either Company name or Domain name.

πŸ’‘ Note: Keep the default identifier mapping unless you have a specific reason to change it. The admin can update mappings at any time.

Troubleshooting

Lusha widget not visible in HubSpot

Make sure Lusha Everywhere is enabled in your extension settings. This is required for the Lusha widget to appear inside HubSpot.

Can't find a contact that Lusha says exists in HubSpot

Do a global search in HubSpot using the contact's email address. Check for archived or hidden records, or any filtered views that might be excluding the contact. If found, unhide or restore it β€” there's no need to re-export from Lusha.

Only seeing a "Disconnect" button with no field mapping options

Field mapping is restricted to Admins. Ask your account Admin to configure field mapping, or request Admin permissions.

Owner mapping issues

If HubSpot is rejecting contact exports due to an owner field error, check that the owner mapping uses a predefined numeric HubSpot owner ID β€” not a name or email. Remove the owner field mapping if it's not required.

Lusha is not found in the HubSpot Marketplace

You can connect directly without using the Marketplace:

  1. Go to Settings β†’ Integrations β†’ HubSpot β†’ Connect in Lusha.

  2. Verify Marketplace access or regional availability in your HubSpot account if needed.

For additional help, see HubSpot common errors or contact Lusha Support via the chat icon in your dashboard.

Did this answer your question?