Auto-enrich new contacts with Lusha inside HubSpot Breeze

This workflow triggers the moment a new Contact is created in HubSpot. It calls the Lusha API via a webhook action to enrich the contact and company, then writes verified data back to the HubSpot record before a rep opens it.

API reference

POST https://api.lusha.com/v2/contacts/search

Headers:
  api_key: YOUR_LUSHA_API_KEY
  Content-Type: application/json

Body: { "emailAddress": "{{contact.email}}" }

Map response to HubSpot contact properties:
  data.jobTitle        → lusha_job_title
  data.seniority       → lusha_seniority
  data.department      → lusha_department
  data.phoneNumbers[0] → lusha_direct_dial
  data.phoneNumbers[1] → lusha_mobile
  data.emailAddress    → email (if empty)

POST https://api.lusha.com/v2/companies/search

Body: { "name": "{{contact.company}}" }

Map response to HubSpot company properties:
  data.industry        → lusha_industry
  data.employeeCount   → lusha_employee_count
  data.revenueRange    → lusha_revenue_range
  data.fundingStage    → lusha_funding_stage
  data.hqLocation.city → city

Custom properties to create in HubSpot

In HubSpot, go to Settings → Properties → Create property. Add these to the Contact object:

Add these to the Company object:

Contact record before and after

Build steps

1. Get your Lusha API key. Log in to Lusha → Settings → API. Copy your key. Full documentation at docs.lusha.com/guides.
2. Create custom properties. In HubSpot Settings → Properties, add the Contact and Company properties listed above.
3. Build the Workflow. In HubSpot → Automation → Workflows → Create Workflow → Contact-based. Set enrollment trigger to “Contact is created.”
4. Add the contact webhook action. Add action → Send a webhook. Method: POST. URL: https://api.lusha.com/v2/contacts/search. Add header: api_key: YOUR_LUSHA_API_KEY. Request body: { "emailAddress": "{% raw %}{{contact.email}}{% endraw %}" }.
5. Add Set property actions for contact fields. For each Lusha response field, add a “Set property value” action and map the webhook response to the corresponding custom property.
6. Add the company webhook action. Repeat for /v2/companies/search with the company name. Map response fields to Company properties.
7. Set the enrichment date. Add a final “Set property value” action to write today’s date to lusha_enriched_date.
8. Test with a live contact. Create a test contact with a known email. Confirm all Lusha properties populate within 30 seconds. Check the Workflow history tab if properties are empty.

Example outputs in this workflow are illustrative — they reflect the structure, fields, and format of real Lusha API output, but were not pulled from a live session. Build this workflow with your own Lusha API key and HubSpot portal to see live results.