Skip to main content

Hubspot Contact Data Enrichment

Carolina Portela avatar
Written by Carolina Portela
Updated today

Overview

Enrich Hubspot Contact Data with Lusha's API key based on Full Name and Domain parameters without requiring any additional applications or special JSON codes.

Requirements

This workflow requires an active HubSpot subscription with the necessary feature enabled, along with the inclusion of Lusha

resources (such as an API token for the account and available bulk credits).

Lusha’s API key can be found here (visible only by Lusha admins or managers).

Step 1: Access HubSpot's Workflow Automation

  1. Log in to your HubSpot account.

  2. Navigate to the Automation section from the main dashboard.

  3. Select Workflows from the dropdown menu.

Step 2: Create a New Workflow

  1. Click on the Create workflow button.

  2. Choose a Blank workflow to start from scratch.

  3. Name your workflow appropriately, such as "Contact Enrichment Workflow” (this specific example is going to refer to the contact enrichment using Lusha’s Person V2 endpoint).

Step 3: Set the Enrollment Trigger

  1. Select Set enrollment trigger to specify the criteria for contacts to enter the workflow.

  2. Choose a property-based trigger (e.g., when a contact's property changes or is updated).

  3. Configure the trigger according to your specific needs (e.g., "Contact created" or "Filtering by owner").

Step 4: Add a Webhook Action

  1. Click on the plus icon (+) to add an action after the enrollment trigger.

  2. Select Webhook from the available actions.

  3. In the Webhook configuration, enter the Webhook URL that will be used to send the contact data for enrichment. You can see all Lusha’s available endpoints here.

  4. Choose the HTTP method (e.g., GET).

  5. Set up the Query Parameters to include the necessary contact information (e.g., linkedin URL, email or full name + company name/website).

  6. Add any required headers (e.g., Content-Type: application/json). *API key can be found here

Step 5: Test the Webhook

  1. Before activating the workflow, test the webhook by sending a test request.

  2. Ensure that the external system (where the webhook sends data) receives and processes the request correctly.

  3. Check for any errors or issues and adjust the configuration as needed.

  4. Select a property from the response to be added to the contact profile (Such as City and State for instance as in the example below).

Step 6: Activate the Workflow

  1. Once the webhook is successfully tested, return to the workflow editor.

  2. Ensure you have a following step to update the contact (e.g., “Edit Record” to an existing field).

  3. Click on the Review and Publish button.

  4. Activate the workflow to start enriching contacts based on the specified criteria.

Step 7: Monitor Workflow Activity

  1. After activation, monitor the workflow to ensure it functions as expected.

  2. Regularly check the workflow history and any errors reported to troubleshoot any issues.

Step 8: Adjust and Optimize (Optional)

  1. Based on the results, you may need to refine the enrollment criteria or webhook configuration.

  2. Continuously monitor the workflow's performance and make adjustments to improve contact enrichment.

The flow is now finished.

Best Practices

  • Rate Limiting: Be mindful of API rate limits for both HubSpot and Lusha

  • Data Quality: Ensure contact data meets minimum requirements before enrichment

  • Testing: Always test with a small subset of contacts before full deployment

Troubleshooting

Common Issues:

  • Authentication Errors: Verify your Lusha API key is correct and active

  • Missing Data: Check that required fields (email, LinkedIn URL, etc.) are populated

  • Rate Limits: Space out workflow executions if hitting API limits

  • Mapping Errors: Ensure response field names match your HubSpot property configurations

Support Resources

Did this answer your question?