# Lusha — Pipedream Connect

> B2B Lead Enrichment in a Click

- API slug: `lusha` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: CRM
- Website: https://lusha.com
- This page (HTML): https://pipedream.com/apps/lusha
- Tools: 23 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: lusha`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "lusha",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Enrich Companies:
const result = await mcp.callTool({
  name: "lusha-company-enrich",
  arguments: {
    requestId: "Company Request ID",
    companiesIds: ["Enrich Company IDs"],
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Lusha endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.lusha.com/person

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkubHVzaGEuY29tL3BlcnNvbg?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "lusha-company-enrich",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    lusha: { authProvisionId: "apn_xxxxxxx" },
    requestId: "Company Request ID",
    companiesIds: ["Enrich Company IDs"],
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (23)

### `lusha-company-enrich` — Enrich Companies (Write)

Enriches company information based on provided company IDs. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/company-enrich.md

### `lusha-contact-enrich` — Enrich Contacts (Write)

Enriches contacts based on provided IDs. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/contact-enrich.md

### `lusha-get-company-recommendations` — Get Company Recommendations (Read-only)

Get company recommendations based on other companies. Use requestId to get more results from a previous search. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/get-company-recommendations.md

### `lusha-get-company-signals` — Get Company Signals By IDs (Read-only)

Retrieve signals data for a list of company IDs. This endpoint allows you to get recent activities and signals for up to 100 companies per request. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/get-company-signals.md

### `lusha-get-contact-recommendations` — Get Contact Recommendations (Read-only)

Fetch recommended contacts by supplying the contact's IDs, enabling Lusha to return similar profiles aligned by job title, seniority, and company context. Use requestId to get more results from a previous search. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/get-contact-recommendations.md

### `lusha-get-contact-signals` — Get Contact Signals By IDs (Read-only)

Retrieve signals data for a list of contact IDs. This endpoint allows you to get recent activities and signals for up to 100 contacts per request. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/get-contact-signals.md

### `lusha-get-signal-options` — Get Signal Options (Read-only)

Retrieve available signal options for a specific entity type (contact or company). This endpoint returns the list of signal types you can filter by when enriching contacts or companies. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/get-signal-options.md

### `lusha-list-naics-codes-options` — List Company NAICS Codes Options (Read-only)

Retrieves available options for the Company NAICS Codes field.

Full schema: https://pipedream.com/apps/lusha/actions/list-naics-codes-options.md

### `lusha-list-revenues-options` — List Company Revenues Options (Read-only)

Retrieves available options for the Company Revenues field.

Full schema: https://pipedream.com/apps/lusha/actions/list-revenues-options.md

### `lusha-list-sic-codes-options` — List Company SIC Codes Options (Read-only)

Retrieves available options for the Company SIC Codes field.

Full schema: https://pipedream.com/apps/lusha/actions/list-sic-codes-options.md

### `lusha-list-sizes-options` — List Company Sizes Options (Read-only)

Retrieves available options for the Company Sizes field.

Full schema: https://pipedream.com/apps/lusha/actions/list-sizes-options.md

### `lusha-list-countries-options` — List Contact Countries Options (Read-only)

Retrieves available options for the Contact Countries field.

Full schema: https://pipedream.com/apps/lusha/actions/list-countries-options.md

### `lusha-list-departments-options` — List Contact Departments Options (Read-only)

Retrieves available options for the Contact Departments field.

Full schema: https://pipedream.com/apps/lusha/actions/list-departments-options.md

### `lusha-list-seniority-options` — List Contact Seniority Levels Options (Read-only)

Retrieves available options for the Contact Seniority Levels field.

Full schema: https://pipedream.com/apps/lusha/actions/list-seniority-options.md

### `lusha-list-existing-data-points-options` — List Existing Data Points Options (Read-only)

Retrieves available options for the Existing Data Points field.

Full schema: https://pipedream.com/apps/lusha/actions/list-existing-data-points-options.md

### `lusha-search-and-enrich-companies` — Search and Enrich Companies (Read-only)

Search for companies and enrich them. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/search-and-enrich-companies.md

### `lusha-search-and-enrich-contacts` — Search and Enrich Contacts (Read-only)

Search for contacts and enrich them. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/search-and-enrich-contacts.md

### `lusha-company-search` — Search Companies (Read-only)

Search for companies using various filters. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/company-search.md

### `lusha-search-company-signals` — Search Company Signals (Read-only)

Search for company signals using identifiers like domain name or company name. This endpoint combines search and signal enrichment in a single request. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/search-company-signals.md

### `lusha-search-contact-signals` — Search Contact Signals (Read-only)

Search for contact signals using identifiers like LinkedIn URL, email, or name + company. This endpoint combines search and signal enrichment in a single request. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/search-contact-signals.md

### `lusha-contact-search` — Search Contacts (Read-only)

Search for contacts using various filters. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/contact-search.md

### `lusha-single-company-search` — Search Single Company (Read-only)

Search for companies using various filters. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/single-company-search.md

### `lusha-single-contact-search` — Search Single Contact (Read-only)

Search for a single contact using various filters. See the documentation

Full schema: https://pipedream.com/apps/lusha/actions/single-contact-search.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt