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

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# Lusha

> Connect Lusha to enrich contacts and companies with verified contact information.

## How to set up Lusha

### Authentication

Lusha uses API key authentication:

1. Log in to your Lusha account
2. Navigate to **Settings** → **API**
3. Generate or copy your API key
4. Paste the API key in Cargo when connecting

## Lusha actions

### Enrich

Retrieve detailed information about a person or company.

**For Person enrichment:**

**Required fields:**

* **Object type**: Person
* **Fields**: Provide identifying information:
  * First name
  * Last name
  * Email
  * Company name
  * Company domain
  * LinkedIn URL
* **Filter by**: Choose to return Email or Phone data

**Optional fields:**

* **Refresh Job Info**: Enable real-time job updates

> **Tip:** Provide at least first name, last name, and company name or domain for best results.

**For Company enrichment:**

**Required fields:**

* **Object type**: Company
* **Fields**: Provide company name or domain

**Use cases:**

* Enrich leads with verified email addresses
* Find direct phone numbers for sales outreach
* Verify and update contact information
* Get company firmographic data

### Search

Search for contacts or companies matching specific criteria.

**For Contact search:**

* **Fields**: Define contact search criteria
* **Company fields**: Filter by company attributes
* **Limit**: Maximum records to return

**For Company search:**

* **Fields**: Define company search criteria
* **Limit**: Maximum records to return

**Use cases:**

* Build targeted prospect lists
* Find contacts at specific companies
* Discover companies matching your ICP

## Credits

Lusha uses a credit-based system:

* **Search**: 3 credits per search (fixed) or 3 credits per item when enriching
* **Enrich**: 3 credits per request

Cargo tracks credit usage and supports caching to optimize costs.

## Enrichment data

### Person data includes:

* Full name
* Email addresses (work and personal)
* Phone numbers (direct, mobile)
* Current job title
* Company information
* LinkedIn profile
* Location

### Company data includes:

* Company name
* Domain
* Industry
* Employee count
* Location
* Revenue range
* LinkedIn company page

## Best practices

* Provide multiple data points for higher match rates
* Use caching to avoid re-enriching the same contacts
* Enable "Refresh Job Info" for contacts that may have changed roles
* Combine with other enrichment sources for comprehensive profiles

## Rate limits

Lusha API allows up to 50 requests per second. Cargo handles rate limiting automatically.