{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"HubSpot contact data enrichment","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.","siteUrl":"https://docs.lusha.com","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-contact-data-enrichment","__idx":0},"children":["HubSpot contact data enrichment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide shows you how to enrich HubSpot contact records with Lusha data using HubSpot's built-in workflow automation and Lusha's Person API. No additional apps or JSON configuration are required — just your Lusha API key."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: You'll need an active HubSpot subscription with Workflows enabled, a Lusha API key (visible to Admins and Managers at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/enrich/api"},"children":["dashboard.lusha.com/enrich/api"]},"), and available bulk credits on your Lusha account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-access-hubspot-workflow-automation","__idx":1},"children":["Step 1: Access HubSpot workflow automation"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your HubSpot account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automation → Workflows"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-create-a-new-workflow","__idx":2},"children":["Step 2: Create a new workflow"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create workflow"]}," and choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Blank workflow"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Name it something descriptive, such as \"Contact Enrichment Workflow\"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-set-the-enrollment-trigger","__idx":3},"children":["Step 3: Set the enrollment trigger"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Set enrollment trigger"]}," and choose a property-based trigger (e.g., \"Contact created\" or a custom filter)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the trigger to match your specific needs."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/65330316/aa34da7124830f0fb8e283ddc24e/8a8fa1c1-4b85-48e0-b128-cb4430b2c95e.png?expires=1780056000&signature=873df1250e6b5cdea10e79cddf1617d8dd42100d6006b9d1790a0f696b32dc39&req=1tBsxlj5rTFk2hj99dpg6s%2BJKOnLWpkJnpdHOsaQFa4xPRgYAQn3kigwb0PK%0A4hAeNNK%2FpyKlA8RsUOpvWckz%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-add-a-webhook-action","__idx":4},"children":["Step 4: Add a webhook action"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," icon to add an action."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhook"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com"},"children":["Lusha API endpoint URL"]}," in the Webhook URL field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the HTTP method to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GET"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add query parameters for the contact identifiers you want to use (e.g., LinkedIn URL, email, or full name + company domain)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add a request header with your Lusha API key. Your API key is available at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/enrich/api"},"children":["dashboard.lusha.com/enrich/api"]},"."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/65330441/f2bb230bf1fff6b8d749ed064dd6/22.png?expires=1780056000&signature=72ac1264e50b81e7a96183207d8533900cc18f6abca1eccce05d0b31eea3ad9d&req=1tBsxlj%2BqDZk2hj99dpg6h39ytCgx3pukUq4CPr5SxS85CoVjTpg3dy43C1c%0Ar5ge65gDMtxlESrfiZU7XCpq%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-5-test-the-webhook","__idx":5},"children":["Step 5: Test the webhook"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send a test request to verify the webhook is returning data correctly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the response properties you want to map to HubSpot contact fields (for example, City and State)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fix any errors before proceeding."]}]},{"$$mdtype":"Tag","name":"img","attributes":{"src":"https://downloads.intercomcdn.eu/i/o/yu27vhse/65330625/e297290a79a5a2293f82668f1d41/f866e5cd-1808-4235-aa12-6a54e5e9f9ff.png?expires=1780056000&signature=cd4fd1a4cc75315e686dfb2578301ea3045c9ae18ea5bece56eaf217bbde6bdc&req=1tBsxlj8rjJk2hj99dpg6lGdC4xDnSCH%2F47%2FIHPv%2BtWwhcvyXYDL%2B%2FzvzAAJ%0A1SkZq7aVoTf2ZzZUp82hpCuD%0A","alt":"","style":{"maxWidth":"100%","height":"auto"}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-6-activate-the-workflow","__idx":6},"children":["Step 6: Activate the workflow"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit Record"]}," step to write the enriched values back to the contact."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Review and Publish"]},", then activate the workflow."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-7-monitor-and-optimize","__idx":7},"children":["Step 7: Monitor and optimize"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check the workflow history regularly and review any error logs. Adjust the enrollment trigger or field mappings as needed to improve match rates."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tips-for-best-results","__idx":8},"children":["Tips for best results"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Be mindful of Lusha API rate limits and HubSpot workflow execution limits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure contacts have at least one identifier (email, LinkedIn URL, or full name + domain) before entering the workflow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test with a small batch of contacts before activating for your full database."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["🎯 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Top play:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.lusha.com/campus/plays/auto-enrich-incomplete-hubspot-contacts/"},"children":["Auto-enrich incomplete HubSpot contacts"]}," — automatically fill in missing contact data for new HubSpot records using Lusha."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For help, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.lusha.com"},"children":["Lusha API documentation"]},", the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://knowledge.hubspot.com/workflows"},"children":["HubSpot Workflow documentation"]},", or contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@lusha.com"},"children":["support@lusha.com"]},"."]}]},"headings":[{"value":"HubSpot contact data enrichment","id":"hubspot-contact-data-enrichment","depth":1},{"value":"Step 1: Access HubSpot workflow automation","id":"step-1-access-hubspot-workflow-automation","depth":2},{"value":"Step 2: Create a new workflow","id":"step-2-create-a-new-workflow","depth":2},{"value":"Step 3: Set the enrollment trigger","id":"step-3-set-the-enrollment-trigger","depth":2},{"value":"Step 4: Add a webhook action","id":"step-4-add-a-webhook-action","depth":2},{"value":"Step 5: Test the webhook","id":"step-5-test-the-webhook","depth":2},{"value":"Step 6: Activate the workflow","id":"step-6-activate-the-workflow","depth":2},{"value":"Step 7: Monitor and optimize","id":"step-7-monitor-and-optimize","depth":2},{"value":"Tips for best results","id":"tips-for-best-results","depth":2}],"frontmatter":{"title":"HubSpot contact data enrichment","description":"How to enrich HubSpot contact records with Lusha data using HubSpot workflow automation and the Lusha Person API.","seo":{"title":"HubSpot contact data enrichment"}},"lastModified":"2026-06-25T08:28:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/webhooks/hubspot-contact-data-enrichment","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}