Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Lusha API

Give your agents access to Lusha API. Bring your own Lusha key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Lusha

Instant

Lusha is a B2B contact enrichment and prospecting platform for verified emails, phone numbers, and company data. It helps sales and go-to-market teams find accurate lead information faster.

67 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Lusha without a separate account or API key for each one. New accounts start with $2 of free credit.

No Lusha account or key

Your agent calls Lusha through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

About $0.125 per credit; credits depend on the request and results., paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Lusha with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Lusha API to your AI assistant

Use Lusha from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use Lusha through Composio Instant to find contacts with the job title Marketing Director at companies in the Software industry in the United States. Search page 0 with a size of 10. Return the number of matches and their job titles only.

What success looks like

LUSHA_PROSPECT_CONTACTS

Your assistant runs Lusha and replies with the number of matching contacts and their job titles.

Runs on Composio Instant

SDK

Use the Lusha API in your code

Call Lusha from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
LUSHA_PROSPECT_CONTACTS
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["lusha"],
    instant={
        "toolkits": {"enable": ["lusha"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "LUSHA_PROSPECT_CONTACTS",
    arguments={
        "page": 0,
        "size": 10,
        "filters": {
            "contacts": {
                "include": {
                    "jobTitles": [
                        "Marketing Director",
                    ],
                },
            },
            "companies": {
                "include": {
                    "locations": [
                        "United States",
                    ],
                    "industries": [
                        "Software",
                    ],
                },
            },
        },
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["lusha"],
  instant: {
    toolkits: { enable: ["lusha"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "LUSHA_PROSPECT_CONTACTS",
  {
    "page": 0,
    "size": 10,
    "filters": {
      "contacts": {
        "include": {
          "jobTitles": [
            "Marketing Director"
          ]
        }
      },
      "companies": {
        "include": {
          "locations": [
            "United States"
          ],
          "industries": [
            "Software"
          ]
        }
      }
    }
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": {
    "contacts": [
      {
        "jobTitle": "<job title>"
      }
    ],
    "totalMatches": "<match count>"
  },
  "successful": "<true or false>",
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Lusha API tools

23 Lusha tools run on Instant, priced per call with no Lusha key.

Action	Tool slug	What it does	Availability
Enrich Contacts	LUSHA_ENRICH_CONTACTS	Reveal contact data, with optional enrichment from other providers.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Prospect Contacts	LUSHA_PROSPECT_CONTACTS	Find contact previews that match your ideal customer profile filters.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Search and Enrich	LUSHA_SEARCH_AND_ENRICH_CONTACTS	Find contacts from known identifiers and reveal their contact data.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Search Contacts	LUSHA_SEARCH_CONTACTS	Find contact previews from known identifiers before enrichment.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Prospect Companies	LUSHA_PROSPECT_COMPANIES	Find matching companies and optionally save them to a companies table.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Enrich Companies	LUSHA_ENRICH_COMPANIES	Reveal company data and optionally save results to a companies table.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Search and Enrich Companies	LUSHA_SEARCH_AND_ENRICH_COMPANIES	Find companies and reveal requested enrichment fields in one request.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Contact Lookalikes	LUSHA_GET_CONTACT_LOOKALIKES	Find similar contacts and optionally persist them to a contacts table.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Contact Signals	LUSHA_GET_CONTACT_SIGNALS	Get contact signals and optionally persist results to a contacts table.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Find Buying Group Contacts	LUSHA_FIND_BUYING_GROUP_CONTACTS	Identify and score buying-group contacts within target companies.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Get Company Filter Values	LUSHA_GET_COMPANY_FILTER_VALUES	Retrieve valid values for one Lusha company prospecting filter.	Instant$0 per request
Get Company Lookalikes	LUSHA_GET_COMPANY_LOOKALIKES	Find similar companies and optionally persist them to a companies table.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Get Company Signal Filter Values	LUSHA_GET_COMPANY_SIGNAL_FILTER_VALUES	Retrieve valid values for one company signal filter.	Instant$0 per request
Get Company Signal Scores	LUSHA_GET_COMPANY_SIGNAL_SCORES	Score companies by active buying signals.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Get Company Signals	LUSHA_GET_COMPANY_SIGNALS	Get company signals and optionally persist results to a companies table.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Get Contact Filter Values	LUSHA_GET_CONTACT_FILTER_VALUES	Retrieve valid values for one contact prospecting filter.	Instant$0 per request
List Company Filter Types	LUSHA_LIST_COMPANY_FILTER_TYPES	List company prospecting filters and their query requirements.	Instant$0 per request
List Company Signal Filters	LUSHA_LIST_COMPANY_SIGNAL_FILTERS	List company signal filters and their query requirements.	Instant$0 per request
List Company Signal Types	LUSHA_LIST_COMPANY_SIGNAL_TYPES	List all supported company signal types.	Instant$0 per request
List Contact Filter Types	LUSHA_LIST_CONTACT_FILTER_TYPES	Discover contact prospecting filter types and their query requirements.	Instant$0 per request
List Contact Signal Types	LUSHA_LIST_CONTACT_SIGNAL_TYPES	Return every contact signal type supported by Lusha.	Instant$0 per request
Score Contacts by Signal Activity	LUSHA_GET_CONTACT_SIGNAL_SCORES	Score contacts from zero to one by their active buying signals.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off
Search Companies	LUSHA_SEARCH_COMPANIES	Find company previews from known identifiers, optionally including signals.	InstantAbout $0.125 per credit; credits depend on the request and results.36% off

Instant prices are Lusha's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Lusha API use cases and example prompts

Copy a prompt into your agent. Each one uses Lusha with apps you connect through Composio.

Build a role-based prospect list
Use Lusha to find contact previews for people with the job title Head of IT in the software industry in the United States. Add the matching previews to my IT Prospects sheet in Google Sheets, then post the match count and job titles in Slack's #sales channel.
Apps used: Lusha, Google Sheets, Slack
Prepare Acme contacts for outreach
Use Lusha to enrich the contact records for Acme prospects in HubSpot using their existing identifiers. Update the matching records with the returned contact data, then create Gmail drafts for the prospects whose records have enough information to support a relevant introduction.
Apps used: Lusha, HubSpot, Gmail
Report on buyer role coverage
Use Lusha to find contact previews for people with the job titles IT director, security director, and procurement director in the software industry in the United States. Write a role coverage brief with the match count and job titles in my Sales Planning document in Google Docs.
Apps used: Lusha, Google Docs
Refresh Acme prospect records
Use Lusha to search for and enrich the Acme prospect contacts in my Salesforce records using their known identifiers. Update each matching Salesforce record with the contact data Lusha returns, and leave unmatched records unchanged.
Apps used: Lusha, Salesforce

TROUBLESHOOTING

Lusha API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Use LUSHA_SEARCH_CONTACTS to find the contacts first, then pass the returned IDs to LUSHA_ENRICH_CONTACTS.

Set waterfallEnabled to true in LUSHA_ENRICH_CONTACTS to try enabled third-party Data Waterfall providers.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Lusha account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

Start with Lusha.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Lusha tool your agent needs.Free to start.

Start building

Lusha API

What is Composio Instant?

No Lusha account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Lusha API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Lusha API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Lusha API tools

Lusha API use cases and example prompts

Build a role-based prospect list

Prepare Acme contacts for outreach

Report on buyer role coverage

Refresh Acme prospect records

Lusha API troubleshooting

Contact enrichment fails for IDs from another source

Enrichment returns no match from Lusha

An action asks you to connect Lusha

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Firecrawl

Tavily

Exa

Serpapi

Start with Lusha.It takes 30 seconds.