Connect the integration
Connecting your Lusha account to Relevance AI is a straightforward process:- Go to the “Integrations” page in the sidebar of your Relevance AI dashboard.
- Click on “Lusha” from the available integrations.
- Click on the “Add Integration” button.
- Enter your Lusha API key when prompted.
- Once authenticated, your Lusha account will appear as a connected integration.
Tool steps for Lusha
The Lusha integration provides a comprehensive set of actions that your agents can use to enrich leads, find contacts, and gather company intelligence. These actions can be incorporated into your agent’s workflows as tool steps, enabling sophisticated sales automation and prospect research capabilities.Contact Enrichment
Enrich Contacts
Find Contact
Search Contacts
Company Intelligence
Enrich Companies
Find Company
Search Companies
Advanced API Access
Lusha API Call
Use the integration’s API tool step (Advanced)
In addition to the pre-built actions available in the tool directory, you can build custom tools that perform Lusha-specific activities using the Lusha API Call tool step.How to use the Lusha API Call tool step
Create a new tool
Add the Lusha API Call tool step
- Scroll down to Tool-steps
- Search for “Lusha API Call” in the tool step search bar
- Add the Lusha API Call tool step to your workflow
Select your Lusha account
Configure the API endpoint
- Method: Select the HTTP method (GET, POST)
- Endpoint: Enter the API endpoint path (e.g.,
/person) - Body: Add any required request body data with search criteria
Test your API call
Example: Enriching a Contact by Email
Here’s a practical example of using the Lusha API Call tool step to enrich a contact using their email address: API Endpoint:POST /person
Configuration:
- Uses the POST method to request contact enrichment
- Specifies the
/personendpoint for individual contact lookup - Provides the email address as the search parameter
- Returns verified contact information including phone numbers, job title, company details, and social profiles
Common Lusha API Endpoints
Here are some commonly used Lusha API endpoints you can use with the API Call tool step:Person Enrichment
Person Enrichment
- Enrich by email:
POST /personwith{"email": "[email protected]"} - Enrich by LinkedIn:
POST /personwith{"linkedInUrl": "https://linkedin.com/in/username"} - Enrich by name & company:
POST /personwith{"firstName": "John", "lastName": "Doe", "company": "Acme Corp"}
Company Enrichment
Company Enrichment
- Enrich by domain:
POST /companywith{"domain": "example.com"} - Enrich by company name:
POST /companywith{"name": "Acme Corporation"}
Bulk Enrichment
Bulk Enrichment
- Bulk person enrichment:
POST /person/bulkwith array of person objects - Bulk company enrichment:
POST /company/bulkwith array of company objects
Search & Discovery
Search & Discovery
- Search contacts: Use search endpoints with filters for job title, company, location, industry
- Find decision makers: Search for specific roles within target companies
Example use cases
Here are some ways you can leverage the Lusha integration with your agents:Automated Lead Enrichment
Automated Lead Enrichment
Prospect Research Agent
Prospect Research Agent
Lead Qualification Bot
Lead Qualification Bot
Outbound List Builder
Outbound List Builder
CRM Data Enhancement
CRM Data Enhancement
Account-Based Marketing (ABM) Research
Account-Based Marketing (ABM) Research
Recruitment Sourcing Agent
Recruitment Sourcing Agent
Partnership Development Bot
Partnership Development Bot
Best practices
Data Privacy & Compliance
Data Privacy & Compliance
- Only use Lusha data for legitimate business purposes
- Respect GDPR, CCPA, and other privacy regulations in your region
- Include proper opt-out mechanisms in your outreach
- Store enriched data securely and delete when no longer needed
- Review Lusha’s terms of service and acceptable use policy
Credit Management
Credit Management
- Each enrichment request consumes Lusha credits
- Use bulk enrichment endpoints when processing multiple records
- Cache enriched data to avoid duplicate lookups
- Implement logic to check if data already exists before enriching
- Monitor your credit usage through Lusha’s dashboard
- Set up alerts when credits are running low
Data Quality
Data Quality
- Provide as much information as possible in your search queries (email + name + company is better than email alone)
- Validate enriched data before using it in outreach
- Implement fallback logic when Lusha doesn’t find a match
- Regularly update enriched data as contact information changes
- Use Lusha’s confidence scores to assess data reliability
Rate Limiting
Rate Limiting
- Lusha enforces rate limits to ensure service quality
- Implement retry logic with exponential backoff for rate limit errors
- Use bulk endpoints to reduce the number of API calls
- Distribute enrichment tasks over time for large datasets
- Monitor API response codes and handle errors appropriately
Frequently asked questions (FAQs)
What is Lusha and why should I use it?
What is Lusha and why should I use it?
Do I need a Lusha account to use this integration?
Do I need a Lusha account to use this integration?
How do I get my Lusha API key?
How do I get my Lusha API key?
- Log in to your Lusha account
- Navigate to Settings or Account Settings
- Look for “API & Integrations” or “API Access”
- Generate a new API key or copy your existing key
- Use this key when connecting Lusha to Relevance AI
What does 'beta' status mean for the Lusha integration?
What does 'beta' status mean for the Lusha integration?
How many Lusha credits does each enrichment use?
How many Lusha credits does each enrichment use?
- Contact enrichment: 1-2 credits per successful lookup
- Company enrichment: 1 credit per successful lookup
- Bulk operations: Credits per record in the batch
What happens if Lusha doesn't find a match?
What happens if Lusha doesn't find a match?
- Trying alternative search parameters
- Using fallback data sources
- Flagging the record for manual research
- Skipping to the next record in bulk operations
Can I use Lusha for cold outreach?
Can I use Lusha for cold outreach?
- Follow CAN-SPAM, GDPR, CCPA, and other relevant regulations
- Include proper identification and opt-out mechanisms
- Only contact people with legitimate business interest
- Respect do-not-contact lists and preferences
- Review Lusha’s acceptable use policy
How accurate is Lusha's data?
How accurate is Lusha's data?
- Use the most recent enrichment data available
- Implement email verification before sending campaigns
- Update your records regularly
- Use Lusha’s confidence scores when available
- Have a process for handling bounced emails or wrong numbers
Can I enrich contacts from LinkedIn profiles?
Can I enrich contacts from LinkedIn profiles?
What's the difference between 'Find' and 'Search' tool steps?
What's the difference between 'Find' and 'Search' tool steps?
- Find tool steps: Used when you have specific identifying information (email, LinkedIn URL, company domain) and want to retrieve that specific contact or company’s details
- Search tool steps: Used when you want to discover contacts or companies matching certain criteria (job title, industry, location, company size)
Can I integrate Lusha with my CRM?
Can I integrate Lusha with my CRM?
- Pull contacts from your CRM
- Enrich them with Lusha
- Update the CRM with enriched data
- All automatically on a schedule or trigger
Are there rate limits for the Lusha API?
Are there rate limits for the Lusha API?
- Your agent will receive a rate limit error
- Implement retry logic with delays
- Use bulk endpoints when processing many records
- Contact Lusha support if you need higher limits

