{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"HubSpot integration","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"hubspot-integration","__idx":0},"children":["HubSpot integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The HubSpot integration lets you push contacts and companies revealed in Lusha directly into HubSpot. This guide covers how to connect, configure field mapping, and prevent duplicate records."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-connect-hubspot-to-lusha","__idx":1},"children":["Step 1: Connect HubSpot to Lusha"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/"},"children":["Lusha dashboard"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/lusha-integrations"},"children":["Integrations"]}]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HubSpot"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect"]}," — you'll be taken to the HubSpot login page."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign in to HubSpot. (If you're already logged in, this step is skipped.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue to field mapping"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-configure-field-mapping","__idx":2},"children":["Step 2: Configure field mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Field mapping tells Lusha which HubSpot fields to populate when you export. You can map fields for two record types: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Companies"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each Lusha field maps to a HubSpot field. You can change any default mapping using the dropdown."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: By default, all contacts exported to HubSpot are owned by the HubSpot user who connected the integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"default-field-mapping","__idx":3},"children":["Default field mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Lusha field"},"children":["Lusha field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HubSpot field"},"children":["HubSpot field"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Email"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Job title"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Jobtitle"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last Name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["First Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["First Name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seniority"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seniority"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone 2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mobilephone"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Companies"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Lusha field"},"children":["Lusha field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"HubSpot field"},"children":["HubSpot field"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Phone"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Domain"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Country"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Country"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Website"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Website"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Founded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Founded_year"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Employees"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number of employees"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LinkedIn"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Linkedin_company_page"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a full table of available Lusha fields, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/integrations-basics/fields-for-field-mapping-and-descriptions"},"children":["Fields for field mapping and descriptions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-add-predefined-value-fields-optional","__idx":4},"children":["Step 3: Add predefined value fields (optional)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose a record type (Contacts or Companies)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add field"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Predefined Value"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a HubSpot field and enter the fixed value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save changes"]}," before switching tabs."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-set-up-conditional-field-mapping-optional","__idx":5},"children":["Step 4: Set up conditional field mapping (optional)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In Field mapping, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advanced"]}," next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email 1"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Phone 1"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Map"]}," dropdown to define the condition and value."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apply"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save changes"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-export-preferences","__idx":6},"children":["Account export preferences"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["(Available for Admins only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Admins can control whether new records are created in HubSpot when exporting from Lusha — for both Contacts and Companies."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations → HubSpot → ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/lusha-integrations/advancedSettings/hubspot/settings"},"children":["Settings tab"]}]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contact"]}," toggle to enable or disable new contact creation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Company"]}," toggle to enable or disable new company record creation."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: These settings apply to all team members in your account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"hubspot-identifier-duplicate-prevention","__idx":7},"children":["HubSpot identifier (duplicate prevention)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The HubSpot identifier checks whether a contact or company already exists in HubSpot before exporting, preventing duplicate records and saving credits."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations → HubSpot → ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/lusha-integrations/advancedSettings/Hubspot/crmIdentifiers"},"children":["HubSpot Identifier tab"]}]}," to configure the mapping."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lusha matches ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["contacts"]}," using these combinations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["First name + Last name + Company name, or"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["First name + Last name + Company domain, or"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Email address"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["companies"]},", matching uses either the Company name or the Domain name."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Keep the default identifier mapping unless you have a specific reason to change it. The admin can update mappings at any time."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"troubleshooting","__idx":8},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lusha-widget-not-visible-in-hubspot","__idx":9},"children":["Lusha widget not visible in HubSpot"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make sure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lusha Everywhere"]}," is enabled in your extension settings. This is required for the Lusha widget to appear inside HubSpot."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cant-find-a-contact-that-lusha-says-exists-in-hubspot","__idx":10},"children":["Can't find a contact that Lusha says exists in HubSpot"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"only-seeing-a-disconnect-button-with-no-field-mapping-options","__idx":11},"children":["Only seeing a \"Disconnect\" button with no field mapping options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Field mapping is restricted to Admins. Ask your account Admin to configure field mapping, or request Admin permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"owner-mapping-issues","__idx":12},"children":["Owner mapping issues"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lusha-is-not-found-in-the-hubspot-marketplace","__idx":13},"children":["Lusha is not found in the HubSpot Marketplace"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can connect directly without using the Marketplace:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations → HubSpot → Connect"]}," in Lusha."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify Marketplace access or regional availability in your HubSpot account if needed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"duplicate-contacts-are-being-created-in-hubspot-after-exporting-from-lusha","__idx":14},"children":["Duplicate contacts are being created in HubSpot after exporting from Lusha"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If Lusha is creating new contact records instead of updating existing ones, the most common cause is that the HubSpot identifier is not configured or the fields used for matching don't contain data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 1: Check your identifier configuration"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations → HubSpot → HubSpot Identifier tab"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that an identifier is set up for Contacts (email address is the most reliable match field)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If no identifier is configured, set one up now — Lusha will use it for all future exports."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 2: Confirm the matching fields contain data"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're matching on email but contacts in Lusha don't have an email address revealed, the identifier can't match and a new record will be created. Make sure the contacts you're exporting have the relevant field populated before pushing to HubSpot."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Step 3: Clean up existing duplicates in HubSpot"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HubSpot has a built-in duplicate management tool. To merge existing duplicates:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In HubSpot, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts → Actions → Manage duplicates"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review the suggested duplicate pairs and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merge"]}," to consolidate records."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Merging contacts in HubSpot is irreversible. Review each pair carefully before confirming."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For additional help, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/hubspot/hubspot-common-errors"},"children":["HubSpot common errors"]}," or contact Lusha Support via the chat icon in your dashboard."]}]},"headings":[{"value":"HubSpot integration","id":"hubspot-integration","depth":1},{"value":"Step 1: Connect HubSpot to Lusha","id":"step-1-connect-hubspot-to-lusha","depth":2},{"value":"Step 2: Configure field mapping","id":"step-2-configure-field-mapping","depth":2},{"value":"Default field mapping","id":"default-field-mapping","depth":2},{"value":"Step 3: Add predefined value fields (optional)","id":"step-3-add-predefined-value-fields-optional","depth":2},{"value":"Step 4: Set up conditional field mapping (optional)","id":"step-4-set-up-conditional-field-mapping-optional","depth":2},{"value":"Account export preferences","id":"account-export-preferences","depth":2},{"value":"HubSpot identifier (duplicate prevention)","id":"hubspot-identifier-duplicate-prevention","depth":2},{"value":"Troubleshooting","id":"troubleshooting","depth":2},{"value":"Lusha widget not visible in HubSpot","id":"lusha-widget-not-visible-in-hubspot","depth":2},{"value":"Can't find a contact that Lusha says exists in HubSpot","id":"cant-find-a-contact-that-lusha-says-exists-in-hubspot","depth":2},{"value":"Only seeing a \"Disconnect\" button with no field mapping options","id":"only-seeing-a-disconnect-button-with-no-field-mapping-options","depth":2},{"value":"Owner mapping issues","id":"owner-mapping-issues","depth":2},{"value":"Lusha is not found in the HubSpot Marketplace","id":"lusha-is-not-found-in-the-hubspot-marketplace","depth":2},{"value":"Duplicate contacts are being created in HubSpot after exporting from Lusha","id":"duplicate-contacts-are-being-created-in-hubspot-after-exporting-from-lusha","depth":2}],"frontmatter":{"title":"HubSpot integration","description":"How to connect Lusha to HubSpot, configure field mapping, prevent duplicate records, and troubleshoot common issues.","seo":{"title":"HubSpot integration"}},"lastModified":"2026-06-25T08:28:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/hubspot/hubspot-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}