Lusha

Lusha is a B2B contact data platform that provides accurate contact and company information to help sales and marketing teams find and connect with prospects. The Lusha connector enables you to enrich person and company data, perform person and company lookups, run prospecting queries, and retrieve API usage information. This connector is particularly useful for applications that need to enrich contact databases, perform lead research, build prospecting tools, or integrate contact data with CRM and sales systems.

Power end-to-end data operations for your Lusha API with Nexla. Our bi-directional Lusha connector is purpose-built for Lusha, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Lusha or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Lusha workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Lusha credential, you'll need to obtain an API key from your Lusha account. Lusha provides API keys for programmatic access to their contact data and prospecting services through the Lusha dashboard.

To obtain a Lusha API key:

1. Log in to your Lusha account at https://www.lusha.com or your organization's Lusha instance.

2. Navigate to your account settings or dashboard. This is typically accessible from the user menu in the top right corner.

3. In the account settings, locate the API or Developer section. This section contains your API key and usage information.

4. If you don't have an API key, click Generate API Key or Create API Key to create a new API key for your application.

5. Copy the API key immediately after generation, as it may only be displayed once for security purposes. Store it securely, as you'll need it to authenticate API requests.

Lusha API keys are used in the api_key header for all API requests. The API key is sensitive information and should be kept secure. If you've lost your API key, you'll need to generate a new one in your Lusha account settings.

For detailed information about Lusha API authentication and API key management, refer to the Lusha API Documentation.

Authenticate

Credentials required

Authenticate with your Lusha API key.

Field	Required	Secret	Description
API Key	Yes	Yes	Your Lusha API key (keep it secret)

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Lusha

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. In the API Key field, enter the API key that you obtained from your Lusha account settings. This is the secret API key used to authenticate requests to the Lusha API.

   The API key is sensitive information and should be kept secure. If you've lost your API key, you'll need to generate a new one in your Lusha account settings. API keys are used in the api_key header for all API requests.

4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, click the New Data Flow button, and select the desired flow type. Select the Lusha connector tile, then select the credential that will be used to connect to the Lusha API, and click Next; or, create a new Lusha credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Lusha API endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Person Lookup

This endpoint looks up a single person by email, LinkedIn URL, or fullName+company. Use this endpoint when you need to enrich person data, find contact information, or retrieve person details for lead research.

• Optionally, enter the email address of the person to look up in the Email field. You can use email, LinkedIn URL, or fullName+company to search for a person.
• Optionally, enter the full name of the person in the Full Name field. When using fullName, you should also provide company information for better matching.
• Optionally, enter the LinkedIn profile URL in the LinkedIn URL field. This can be used to look up a person by their LinkedIn profile.

The Person Lookup endpoint requires at least one search parameter (email, fullName, or linkedin). The endpoint returns enriched person data including contact information, job title, company, and other professional details. For more information about the Person Lookup endpoint, refer to the Lusha API Documentation.

Company Lookup

This endpoint looks up a single company by domain or name. Use this endpoint when you need to enrich company data, find company information, or retrieve company details for prospecting.

• Optionally, enter the company domain in the Domain field. You can use domain or company name to search for a company.
• Optionally, enter the name of the company in the Company Name field. This can be used to look up a company by its name.

The Company Lookup endpoint requires at least one search parameter (domain or name). The endpoint returns enriched company data including company information, industry, size, and other company details. For more information about the Company Lookup endpoint, refer to the Lusha API Documentation.

Prospect Contact

This endpoint searches contacts using filters and enriches their details. Use this endpoint when you need to perform bulk prospecting, find contacts matching specific criteria, or enrich multiple contacts at once.

• Enter a JSON string with filters for enrichment in the Prospect Filters field. The filters should be formatted as a JSON object, for example: {"company": {"name": "Example Corp"}, "seniority": "C-Level"}. Refer to the Lusha API documentation for the complete list of available filters.

The Prospect Contact endpoint uses POST requests to send filter criteria and returns enriched contact data matching the specified filters. The endpoint supports various filter criteria including company information, job titles, seniority levels, and more. For more information about the Prospect Contact endpoint, refer to the Lusha API Documentation.

Account Usage

This endpoint fetches your API usage report from Lusha. Use this endpoint when you need to monitor API usage, track credit consumption, or analyze API usage patterns.

• This endpoint automatically retrieves your current API usage information. No additional configuration is required beyond selecting this endpoint template.

The Account Usage endpoint returns information about your API usage including credits consumed, remaining credits, and usage statistics. This endpoint is useful for monitoring your API usage and managing your Lusha account. For more information about the Account Usage endpoint, refer to the Lusha API Documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Lusha data sources can also be manually configured to ingest data from any valid Lusha API endpoint not included in the pre-built templates, including chained API calls or custom authentication headers. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

Lusha API endpoints typically follow the pattern https://api.lusha.com/v2/{resource} for v2 endpoints or https://api.lusha.com/v1/{resource} for v1 endpoints, and require the api_key header for authentication (automatically included from your credential). Common paths to data include $ for the entire response or $.contacts[*] for arrays of contacts returned by prospecting endpoints.

For Lusha prospecting endpoints, the request body should be formatted as JSON and typically includes a filters field containing filter criteria for searching contacts (e.g., company, seniority). Refer to the Lusha API documentation for the complete list of available filters.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Lusha data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.