> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lusha

> Connect Lusha to your Agents to find and enrich B2B contacts and companies

## Overview

The Lusha integration gives your agents access to Lusha's B2B contact and company database. Agents can **prospect** for new people and companies that match an ideal customer profile, and **enrich** known contacts with verified emails, direct phone numbers, and firmographics — ideal for lead generation, list building, and CRM data hygiene.

The two tools are designed to chain: prospect to discover matches cheaply, then enrich only the records worth paying for.

## Prerequisites

* A Lusha account on a **Premium or Scale** plan (API access is not available on lower tiers)
* A Lusha **API key**, created by an Admin or Manager from the Lusha **API Hub**

## Setup Guide

<Steps>
  <Step title="Get Your API Key">
    In Lusha, open the **API Hub** (visible to Admins and Managers) and create an API key. Copy it somewhere safe — you'll paste it into Aster Agents.
  </Step>

  <Step title="Connect Lusha in Aster Agents">
    Navigate to **Control Hub > Integrations**, locate the **Lusha** card, click **Connect**, and paste your API key.
  </Step>

  <Step title="Add Tools to Your Agent">
    Edit your agent and enable **Lusha Prospect** and **Lusha Enrich**. Enabling both lets the agent discover matches and then reveal contact data for the best ones.
  </Step>
</Steps>

## Available Tools

* **[Lusha Prospect](/tools/lusha_prospect)** — Discover new people or companies matching an ICP using filters (department, seniority, location, company size, revenue, industry, technologies, intent). Returns cheap, non-PII previews plus each match's id and what data is available to reveal.
* **[Lusha Enrich](/tools/lusha_enrich)** — Enrich known people or companies (by name+company, email, LinkedIn URL, or domain) with verified emails, direct phones, and firmographics.

## How Credits Work

Lusha bills **per data point revealed**, not per request:

| Action                       | Credits            |
| ---------------------------- | ------------------ |
| Reveal email                 | 1 per contact      |
| Reveal phone                 | 5 per contact      |
| Reveal extra company field   | 1 each             |
| Search / prospecting preview | \~1 per 25 results |

To keep spend predictable, **Lusha Enrich reveals emails by default and leaves phones off** — phone numbers (5× the cost) are opt-in per call. Prospecting and previews never reveal PII, so agents can build and qualify a list before spending reveal credits.

<Note>
  The connected API key is shared by all agents in your organization and draws from your organization's Lusha credit balance. Use agent-level tool permissions to control which agents can spend credits.
</Note>

## Security Considerations

* **Protect your API key** — it can spend your Lusha credits and access contact data
* **Rotate API keys** periodically from the Lusha API Hub
* **Grant the Lusha tools only to agents that need them** to control credit usage

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication failed (401)">
    * Verify the API key is correct and active in the Lusha API Hub
    * Re-paste the key in **Control Hub > Integrations**
  </Accordion>

  <Accordion title="Out of credits (402)">
    * Your Lusha credit balance is exhausted — top up your plan or wait for the renewal
    * Reduce phone reveals (5 credits each) and prefer email-only enrichment
  </Accordion>

  <Accordion title="API not available on this plan (403)">
    * API access requires a Lusha **Premium or Scale** plan
    * Confirm the key was created by an Admin or Manager
  </Accordion>

  <Accordion title="Rate limit hit (429)">
    * Lusha enforces per-minute, per-hour, and per-day limits that vary by plan
    * Slow the request rate or wait for the window to reset (the tools surface remaining-request counts)
  </Accordion>

  <Accordion title="No results returned">
    * Loosen your prospecting filters — overly narrow ICPs can return zero matches
    * For enrichment, provide a stronger identifier: email or LinkedIn URL match best, otherwise firstName + lastName + company domain
  </Accordion>
</AccordionGroup>

## Related Tools

* [Lusha Prospect](/tools/lusha_prospect) — find new contacts/companies matching an ICP
* [Lusha Enrich](/tools/lusha_enrich) — reveal emails, phones, and firmographics for known records