You must be both a Lusha Admin and a HubSpot Admin to set up the integration. Only Admins and Managers can edit integration settings.
Export size and background processing
You can export up to 1,000 contacts to HubSpot in a single job. Exports of up to 100 contacts process in real time. Larger exports run in the background in 20 batches - you can keep working while the job runs. If your selection exceeds 1,000 contacts, Lusha exports the first 1,000 and leaves the rest marked Not exported, so your next run picks up automatically. The 1,000-record cap is a HubSpot platform limit and cannot be changed.Only one CRM export can run at a time per user. To track export status and review any failed contacts, go to Account → CRM export.
Step 1: Connect HubSpot to Lusha
1
Log in to Lusha
Log in to your Lusha dashboard.
2
Select HubSpot from Integrations
Go to Settings → Integrations and select HubSpot.
3
Click Connect
Click Connect - you’ll be taken to the HubSpot login page.
4
Sign in to HubSpot
Sign in to HubSpot. (If you’re already logged in, this step is skipped.)
5
Continue to field mapping
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.By default, all contacts exported to HubSpot are owned by the HubSpot user who connected the integration.
Default field mapping
Contact
Companies
For a full table of available Lusha fields, see Fields for field mapping and descriptions.
Step 3: Add predefined value fields (optional)
1
Choose a record type
Choose a record type (Contacts or Companies).
2
Add a predefined value field
Click + Add field and select Predefined Value.
3
Set the field and value
Select a HubSpot field and enter the fixed value.
4
Save changes
Click Save changes before switching tabs.
Step 4: Set up conditional field mapping (optional)
1
Open Advanced mapping
In Field mapping, click Advanced next to Email 1 or Phone 1.
2
Define the condition and value
Use the Map dropdown to define the condition and value.
3
Apply and save
Click Apply, then Save changes.
Account export preferences
(Available for Admins only) Admins can control whether new records are created in HubSpot when exporting from Lusha - for both Contacts and Companies. Go to Settings → Integrations → HubSpot → Settings tab, then use the toggles to control record creation:- Contact toggle - enable or disable new contact creation.
- Company toggle - enable or disable new company record creation.
These settings apply 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
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:- Go to Settings → Integrations → HubSpot → Connect in Lusha.
- Verify Marketplace access or regional availability in your HubSpot account if needed.
Duplicate contacts are being created in HubSpot after exporting from Lusha
If Lusha is creating new contact records instead of updating existing ones, the most common cause is a missing HubSpot identifier configuration. It can also happen when the fields used for matching don’t contain data. Step 1: Check your identifier configuration1
Open the HubSpot Identifier tab
Go to Settings → Integrations → HubSpot → HubSpot Identifier tab.
2
Confirm an identifier is set for Contacts
Confirm that an identifier is set up for Contacts (email address is the most reliable match field).
3
Set up an identifier if missing
If no identifier is configured, set one up now - Lusha will use it for all future exports.
1
Open Manage duplicates
In HubSpot, go to Contacts → Actions → Manage duplicates.
2
Review and merge duplicate pairs
Review the suggested duplicate pairs and click Merge to consolidate records.