Overview
The Lusha Connect connector enables users to access Lusha’s Prospecting API directly from within Workato. This article will guide you through the two key actions in the Prospecting workflow:
Step 1 – Contacts Search
Step 2 – Contacts Enrich
Connector Setup
To get started, you’ll need a Lusha API key and an active Workato account.
Go to your Lusha dashboard and get your API key here.
Paste the key into the
API Keyfield when setting up the connection.
Easy Step-by-Step Setup:
Log into Workato: Open Workato and log in or create an account if you don’t have one.
Install Lusha Connect: Visit the Workato Community Library Lusha Connect page and click “Install” to add the Lusha Connect connector to your account.
Create a New Recipe: In Workato, click “Create Recipe” to start a new automation.
Set Up Your Trigger: Choose an event to initiate the recipe, such as adding a new lead in your CRM.
Add Lusha Connect as an Action: In the action step, search for “Lusha Connect” and select it.
Authenticate with API Key: Enter your Lusha API key when prompted. This will authorize Workato to securely access Lusha’s enriched data.
Configure Fields: Depending on the selected action, map the fields in Workato to ensure the correct data is pulled from Lusha.
Step 1 – Search for Contacts
Use this action to search for relevant B2B contacts by applying advanced filters across contact and company-level criteria.
🔧 Action: [Prospecting] Step 1 - Contacts Search
This action posts a search request to the Lusha Prospecting API and returns a list of matching contacts based on your input filters.
Input Parameters
The search is divided into 3 main filter groups:
1. Contact Filters
Countries – Choose target regions.
Departments – Filter by role (e.g., Sales, Engineering).
Seniority – From entry to C-level.
Job Titles – Use keywords (e.g., "CTO", "Manager").
Cities / States – Narrow down geographically.
Existing Data Points – Ensure the contact has an email or phone.
2. Company Filters
Company Name / Domain – Target specific companies.
Main/Sub Industries – Use predefined industry categories.
Employee Count / Revenue Range – Match company size.
Company Location – Target by geography.
3. Exclusion Filters
Use the same filters above to exclude companies or contacts (e.g., exclude interns or companies in the finance industry).
4. Pagination
Page – Index for the current result set (default = 0).
Size – Number of contacts per request (max = 40).
Main Output Fields
Request ID – Used to retrieve enrichment data in Step 2.
All Contact IDs – All results.
Revealed Contact IDs – Contacts you've already revealed.
New Contact IDs – Contacts you've never revealed.
Step 2 – Enrich Contacts
Once you’ve selected your target contacts, use this action to get full enrichment data (emails, phones, company data, job info, etc.)
🔧 Action: [Prospecting] Step 2 - Contacts Enrich
Enriches contacts returned from a previous search.
Input Parameters
Request ID – From Step 1 output.
Contact IDs – One or more contact IDs to enrich.
Output Fields
Each contact enriched will return:
Full Name, First & Last Name
Emails (with type & confidence)
Phone Numbers (with type & DNC flag)
Job Title, Departments, Seniority
Location – Country, State, City
LinkedIn Profile
Company Info – Name, Industry, Revenue, Employee count, Location, Social links, Technologies, Specialities, Funding, Intent topics
How to Use in a Recipe
To create your first automated workflow (Recipe) with Lusha:
Install Lusha Connect: Go to the Workato Community Library Lusha Connect page and click “Install” to add the Lusha Connect connector to your account.
Create a new recipe: In Workato, click “Create Recipe.”
Select your trigger: Define an event to trigger the recipe, such as adding a new lead in your CRM.
Add Lusha as an Action:
Select the first step (“Prospecting Search Contacts”):
5. Map Fields: In the setup step:
Review the fields available in the Lusha action. Select the ones that align with your data needs.
Add only the fields you require for your workflow. (It’s recommended to avoid adding all fields unless they’re essential for your recipe, to keep it streamlined).
6. Add another Lusha Action:
Select the second step (“Prospecting Enrich Contacts”):
a. Map the “Request Id” from the datapill of the last action output:
b. Select either “All Contacts”, “New Contacts” or “Revealed Contacts”
6. Map Data to the Final Destination: Map the enriched data from Lusha to the desired location within your workflow, ensuring it appears where it’s needed.
7. Test and Activate the Recipe: Run a test to ensure everything works as expected. Then, activate the recipe to start using it.
Tips & Best Practices
Use "new_contact_ids" to reveal only unseen contacts.
Apply exclusion filters to optimize API credit usage.
Use Dynamic Fields: Whenever possible, use Workato’s dynamic fields to pass information like email addresses or company names directly into the Lusha connector, ensuring accuracy and efficiency.
Monitor API Usage: Keep an eye on your API usage within Lusha, as enrichment calls can consume API credits.
Regular Testing: Periodically test your recipes to confirm that data flows smoothly and meets your needs.
For further assistance, consult the following:
Workato Help Center: For general guidance on building workflows in Workato.
Lusha Support: If you need specific help with your API key or access permissions, contact Lusha Support.