Skip to main content
Lusha logo
  • Category: people & contact data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 67
  • Triggers: 0
  • Slug: LUSHA
  • Version: 20261103_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: LUSHA_ADD_COMPANIES_TABLE_ENTITIESAdd Lusha companies to an existing companies table.

Input Parameters

object
required
Owner required for API-key authentication.
string
required
The table’s ID.
array
required
Lusha company IDs to add to the companies table.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_ADD_CONTACTS_TABLE_COLUMNSAdd contacts-table columns using exactly one of columns or columnKey; added columns populate asynchronously.

Input Parameters

object
required
Owner required for API-key authentication.
array
Columns to add.
string
required
The contacts table ID.
string
One catalog column key.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_ADD_CONTACTS_TABLE_ENTITIESAdd up to 500 contacts to an existing table.

Input Parameters

object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string
required
The contacts table ID.
array
required
Lusha contact IDs to add to the contacts table.
array
Contacts tables only. One company ID per contact, index-aligned with entityIds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_CREATE_COMPANIES_TABLECreate a companies table, optionally seeded with Lusha company IDs.

Input Parameters

array
Optional initial entity IDs to seed the table with.
string
required
Name for the new table.
object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string ("private" | "shared")
Who can access the table.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_CREATE_CONTACTS_TABLECreate a contacts table, optionally seeded with contact IDs.

Input Parameters

array
Optional initial entity IDs to seed the table with.
string
required
Name for the new table.
object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string ("private" | "shared")
Who can access the table.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_CREATE_OPT_OUT_SUBSCRIPTIONCreate a webhook subscription for contact opt-out notifications.

Input Parameters

string
required
Your webhook endpoint URL (HTTPS required in production)
string
Descriptive name for this subscription
string
Entity type for opt-out subscriptions. Currently only contact is supported.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_CREATE_SUBSCRIPTIONCreate up to 25 webhook subscriptions per request for real-time Lusha signal notifications, such as contact job changes or company updates. Unavailable with managed Lusha connections.

Input Parameters

string
Default subscription name prefix.
object
required
Default values applied to all subscriptions. Required fields: url. Optional fields: entityType, signalTypes.
array
required
Array of subscriptions to create (max 25 in production).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_DELETE_COMPANIES_TABLEPermanently delete a companies table and its table data.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The table’s ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_DELETE_CONTACTS_TABLEPermanently delete a contacts table and all of its data.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The contacts table ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_DELETE_SUBSCRIPTIONSDelete up to 25 webhook subscriptions by ID in one request and return a summary of successful and failed attempts. Unavailable with managed Lusha connections.

Input Parameters

array
required
Array of subscription IDs to delete. Maximum 25 IDs per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_ENRICH_COMPANIESReveal company data and optionally persist results to a companies table.

Input Parameters

array
required
Company IDs from search results (strings)
array
Additional data fields to reveal. Each field is charged separately per result. - employeesByDepartment - breakdown of employees by department - employeesByLocation - breakdown of employees by country/state - employeesBySeniority - breakdown of employees by seniority level - competitors - list of competitor company IDs - intent - buyer intent topics - estimatedAnnualItSpend - estimated annual IT spend. - monthlyWebsiteTraffic - monthly website traffic and month-over-month change. - openJobsTotal - reveals the total open job count. In the response, this appears as the total field inside the openJobs object. - openJobsByDepartment - reveals open job counts broken down by department. In the response, this appears as the byDepartment field inside the openJobs object. - openJobsByLocation - reveals open job counts broken down by location. In the response, this appears as the byLocation field inside the openJobs object. - openJobsBySeniority - reveals open job counts broken down by seniority level. In the response, this appears as the bySeniority field inside the openJobs object. - directParent - the company’s immediate parent in its ownership tree. - ultimateParent - the company at the top of its ownership tree.
string
Optional. If provided, these companies are also added to this table (if not already present) and the revealed fields’ columns are populated. See the Tables API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_ENRICH_CONTACTSReveal contact data, optionally using BYOK Data Waterfall providers.Instant: Supported on the latest version.Instant pricing: About $0.125 per credit; credits depend on the request and results.Discount: 36

Input Parameters

array
required
One to 100 contact IDs returned by a Lusha search.
array
Lusha data points to reveal. Omit to request both emails and phones.
boolean
Set true to use enabled third-party Data Waterfall providers when Lusha has no match. Defaults to false for Lusha-only enrichment. Managed calls must leave this false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_FIND_BUYING_GROUP_CONTACTSIdentify and score buying-group contacts within target companies.

Input Parameters

array
Filter results to specific persona roles. Omit to return all three.
array
required
Companies whose buying groups to find.
object
Optional. If omitted, defaults to page 0, size 100.
integer
Maximum number of contacts returned per company.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_ACCOUNT_USAGERetrieve the connected Lusha account’s usage, limits, plan, and pricing. Unavailable with managed Lusha connections.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_AUDIT_LOGSRetrieve account audit logs for API calls and webhook deliveries to review delivery status, errors, and performance metrics. Filter by subscription or delivery status and paginate using limit and offset. Unavailable with managed Lusha connections.

Input Parameters

integer
Maximum number of results (1-100)
integer
Number of results to skip
string ("success" | "failed" | "permanent_failure")
Status of audit log delivery.
string
Filter by subscription ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_AUDIT_LOG_STATSRetrieve aggregated audit-log delivery statistics, including total, successful and failed counts and success rate, optionally filtered by subscription ID. Use these statistics to monitor delivery success. Unavailable with managed Lusha connections.

Input Parameters

string
Filter statistics by subscription ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANIES_TABLEGet a companies table’s metadata, status, counts, and columns.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The table’s ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANIES_TABLE_ENTITIESRead a page of company rows and column values from a table.

Input Parameters

integer
Zero-based page number.
integer
Rows to return per page.
string
required
Table owner email required by API-key auth.
string
required
The table’s ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_FILTER_VALUESRetrieve valid values for one Lusha company prospecting filter.

Input Parameters

string
Search text. Required for names, technologies, and locations.
string ("names" | "sizes" | "revenues" | "locations" | "sics" | "naics" | "industriesLabels" | "intentTopics" | "technologies")
required
Company prospecting filter whose valid values should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_ICP_FIT_SCORESScore companies against the connected user’s Target Profiles.

Input Parameters

array
required
Companies to score against the target profiles.
array
required
1-3 Target Profile IDs to score against. Each must be an active profile you own or that is shared with your account - get them from List Target Profiles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_LOOKALIKESFind similar companies and optionally persist them to a companies table.

Input Parameters

integer
Maximum lookalike companies to return.
object
required
5 to 100 seed companies in total across all identifier types.
object
Optional. Companies to always filter out of the results (for example, existing customers or competitors). Omit the field entirely if you have nothing to exclude. Subject to the same 100-per-identifier-type cap as seeds, but has no minimum.
string
Optional. If provided, results are also persisted to this table. See the Tables API.
string
Session ID from a prior page to exclude repeated results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_RECOMMENDATIONSReturn companies ranked for the user by Target Profiles and recent signals.

Input Parameters

array
Up to 4 sort keys, all using the same order.
object
Criteria recommendations must match.
object
Page and page size for recommendations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_SIGNAL_FILTER_VALUESRetrieve valid values for one company signal filter.

Input Parameters

string
Text to match against filter values. Required for hiringByLocations and intentTopics; forbidden for intentCategories; optional for newsEventTypes and hiringByDepartments.
string ("newsEventTypes" | "hiringByDepartments" | "hiringByLocations" | "intentCategories" | "intentTopics")
required
Company signal filter whose valid values should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_SIGNALSGet company signals and optionally persist results to a companies table.

Input Parameters

array
required
Lusha company IDs to retrieve signals for.
object
Optional intent signal filters.
string
Optional. If provided, these companies are also added to this table (if not already present) and the Signals column is populated. See the Tables API.
string
For linkedinActivityIntent, results are limited to a trailing 90-day window regardless of the value passed (legal requirement). Other signal types are unaffected.
array
required
Signal types to retrieve. allSignals returns every company signal type except the four intent types (newIntentTopic, intentScoreIncrease, intentScoreDecrease, intentTopicRemoved) - name those explicitly to get them.
integer
For linkedinActivityIntent, results are capped at 50 per company regardless of the value passed. Other signal types use the requested value as-is (1-100). For the intent types, the cap applies after intentTopics / intentCategories filtering.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_COMPANY_SIGNAL_SCORESScore companies by active buying signals.

Input Parameters

array
required
Companies to score by active signals.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACT_FILTER_VALUESRetrieve valid values for one contact prospecting filter.

Input Parameters

string
Text to match against filter values. Required for locations.
string ("departments" | "seniority" | "existingDataPoints" | "countries" | "locations")
required
Contact prospecting filter whose valid values should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACT_ICP_FIT_SCORESScore contacts against user-owned or shared Lusha Target Profiles.

Input Parameters

array
required
Contacts to score against the target profiles.
array
required
1-3 Target Profile IDs to score against. Each must be an active profile you own or that is shared with your account - get them from List Target Profiles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACT_LOOKALIKESFind similar contacts and optionally persist them to a contacts table.

Input Parameters

integer
Maximum lookalike contacts to return.
object
required
5 to 100 seed contacts in total across all identifier types.
object
Optional. Contacts to always filter out of the results (for example, existing customers). Omit the field entirely if you have nothing to exclude. Subject to the same 100-per-identifier-type cap as seeds, but has no minimum.
string
Optional. If provided, results are also persisted to this table. See the Tables API.
string
Session ID from a prior page to exclude repeated results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACT_RECOMMENDATIONSReturn a user’s contacts ranked against Target Profiles and recent signals.

Input Parameters

array
Up to 4 sort keys, all using the same order.
object
Criteria recommendations must match.
object
Page and page size for recommendations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACTS_ENRICH_JOBPoll one async contact Data Waterfall job without incurring a polling charge.

Input Parameters

string
required
Async job ID returned in the job.id field by Enrich Contacts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACT_SIGNALSGet contact signals and optionally persist results to a contacts table.

Input Parameters

array
required
Lusha contact IDs to retrieve signals for.
string
Optional. If provided, these contacts are also added to this table (if not already present) and the Signals column is populated. See the Tables API.
string
Earliest signal date to include.
array
required
Contact signal categories to retrieve.
integer
Maximum results returned for each signal category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACT_SIGNAL_SCORESScore contacts from zero to one by their active buying signals.

Input Parameters

array
required
Contacts to score by active signals.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACTS_TABLEGet a contacts table’s metadata, entity count, processing status, and columns with row-status counts.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The contacts table ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONTACTS_TABLE_ENTITIESRead one page of contacts and column values from a table.

Input Parameters

integer
Zero-based page number.
integer
Number of rows to return.
string
required
Table owner email required by API-key auth.
string
required
The contacts table ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_CONVERSATION_TRANSCRIPTFetch the speaker-attributed transcript for one conversation.

Input Parameters

string
required
Conversation identifier returned by Search Conversations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_SUBSCRIPTIONRetrieve a webhook subscription by ID, including its status, configuration, and entity details. Unavailable with managed Lusha connections.

Input Parameters

string
required
The unique identifier of the subscription to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_GET_WEBSITE_VISITSReturn companies ranked by visits to the connected user’s tracked sites.

Input Parameters

object
Optional result ordering.
array
required
Domains configured for tracking in the Lusha dashboard.
string
required
Window end date. The range from startDate must be at most 3 months.
object
Optional visit metrics and country filters.
string
required
Window start date (YYYY-MM-DD).
object
required
Page and page size for visit results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_COMPANIES_COLUMN_CATALOGList Lusha columns that can be added to a companies table.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_COMPANIES_TABLESList company tables visible to the resolved owner.

Input Parameters

string
Optional filter - matches tables whose name contains this text.
integer
Zero-based results page.
integer
Tables to return per page.
object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string ("active" | "archived")
deleted is not a filterable status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_COMPANY_FILTER_TYPESList company prospecting filters and their query requirements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_COMPANY_RECOMMENDATION_FILTERSList Target Profiles and signals available to company recommendations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_COMPANY_SIGNAL_FILTERSList company signal filters and their query requirements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_COMPANY_SIGNAL_TYPESList all supported company signal types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_CONTACT_FILTER_TYPESDiscover contact prospecting filter types and their query requirements.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_CONTACT_RECOMMENDATION_FILTERSList the Target Profiles and signals available to the current user’s recommendations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_CONTACTS_COLUMN_CATALOGList the Lusha columns available to add to a contacts table.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_CONTACT_SIGNAL_TYPESReturn every contact signal type supported by Lusha.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_CONTACTS_TABLE_COLUMNSList a contacts table’s columns and per-cell status counts.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The contacts table ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_CONTACTS_TABLESList contacts tables visible to an owner.

Input Parameters

string
Optional filter - matches tables whose name contains this text.
integer
Zero-based results page.
integer
Tables to return per page.
object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string ("active" | "archived")
deleted is not a filterable status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_ICP_PROFILESList Target Profiles available to the connected Lusha user.

Input Parameters

string ("private" | "shared")
Return only private or account-shared profiles.
string ("active" | "disabled")
Return only profiles with this status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_LIST_SUBSCRIPTIONSList account webhook subscriptions with pagination to review their settings and active status. Unavailable with managed Lusha connections.

Input Parameters

integer
Maximum number of results (1-100)
integer
Number of results to skip

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_POPULATE_COMPANIES_TABLE_COLUMNAsynchronously populate or refresh one companies-table column across selected rows.

Input Parameters

object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string ("all" | "missing" | "specific")
required
Rows to run: all, missing, or specific.
string
required
The table’s ID.
string
required
The column’s ID.
array
Required when runScope is specific.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_POPULATE_CONTACTS_TABLE_COLUMNAsynchronously populate or refresh one contacts-table column.

Input Parameters

object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string
required
The contacts table ID.
string
required
The table column ID.
string ("all" | "missing" | "specific")
required
Rows to run: all, missing, or specific.
array
Row IDs required for a specific run.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_PROSPECT_COMPANIESFind matching companies and optionally persist them to a companies table.

Input Parameters

object
required
Contact filters cannot be combined with company searchText, signals, intent, or technologies filters.
object
Optional prospecting result controls.
string
Optional. If provided, results are also persisted to this table. See the Tables API.
object
required
Page and page size for prospects.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_PROSPECT_CONTACTSSearch Lusha contacts by ICP filters and return one page of previews.Instant: Supported on the latest version.Instant pricing: About $0.125 per credit; credits depend on the request and results.Discount: 36

Input Parameters

integer
Page number from 0 to 1000.
integer
Results per page from 10 to 100.
object
required
Include or exclude criteria with at least one of contacts or companies.
boolean
Exclude contacts whose phones are all marked Do Not Call; plan-gated.
integer
Maximum contacts per company; omit for uncapped results.
boolean
Whether partial profiles may be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_REMOVE_COMPANIES_TABLE_COLUMNRemove a non-default companies-table column and delete its cell data.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The table’s ID.
string
required
The column’s ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_REMOVE_COMPANIES_TABLE_ENTITIESRemove company rows from a companies table.

Input Parameters

object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string
required
The table’s ID.
array
required
Accepts either the encrypted token (v{N}.…, as returned by Get Entities) or the legacy numeric ID. Unresolved IDs are echoed back in invalidIds in the exact form you sent them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_REMOVE_CONTACTS_TABLE_COLUMNRemove a non-default column and its cell data from a contacts table.

Input Parameters

string
required
Table owner email required by API-key auth.
string
required
The contacts table ID.
string
required
The table column ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_REMOVE_CONTACTS_TABLE_ENTITIESRemove specific contacts from a table.

Input Parameters

object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
string
required
The contacts table ID.
array
required
Accepts either the encrypted token (v{N}.…, as returned by Get Entities) or the legacy numeric ID. Unresolved IDs are echoed back in invalidIds in the exact form you sent them.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_SEARCH_AND_ENRICH_COMPANIESFind companies and reveal requested enrichment fields in one request.

Input Parameters

array
Additional data fields to reveal, using the same tokens as Enrich Companies. Each field is charged separately per result. Premium fields are returned only when named here - omitting reveal returns base firmographics alone. See Enrich Companies for what each token unlocks.
object
Additional options for search requests
array
required
Companies to find and enrich.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_SEARCH_AND_ENRICH_CONTACTSFind contacts from known identifiers and reveal their contact data.Instant: Supported on the latest version.Instant pricing: About $0.125 per credit; credits depend on the request and results.Discount: 36

Input Parameters

array
Contact data to reveal: emails, phones, or both.
object
Additional contact search options.
array
required
One to 100 contacts identified by Lusha ID, LinkedIn URL, email, or name and company.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_SEARCH_COMPANIESFind company previews from known identifiers, optionally including signals.

Input Parameters

object
Additional options for search requests
object
Optional company signals to include.
array
required
Companies to find from known identifiers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_SEARCH_CONTACTSFind contact previews from known identifiers before enrichment.Instant: Supported on the latest version.Instant pricing: About $0.125 per credit; credits depend on the request and results.Discount: 36

Input Parameters

object
Optional controls for partial profile matching.
object
Optional recent-activity criteria for matching contacts.
array
required
One to 100 contacts identified by Lusha ID, LinkedIn URL, email, or name and company.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_SEARCH_CONVERSATIONSSearch processed Lusha sales conversations by transcript or filters.

Input Parameters

integer
Page number, starting at 1.
string
Free-text search over transcript content. When present, the structural filters below are ignored.
string
Latest meeting date, inclusive (YYYY-MM-DD).
string
Earliest meeting date, inclusive (YYYY-MM-DD).
integer
Conversations per page. Values above 100 are rejected with 400 (not silently clamped).
array
Partial, case-insensitive match on participant names. Multiple values are ORed.
array
Partial, case-insensitive match on the meeting title. Multiple values are ORed.
array
Company domains of the external participants (e.g. acme.com). Matches on domain, not display name. Multiple values are ORed.
array
Return only these conversations. IDs that don’t exist, are still processing, or belong to another account are omitted from the response rather than erroring.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_UPDATE_COMPANIES_TABLERename, archive, restore, or change visibility for a companies table.

Input Parameters

string
New table name.
object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
boolean
Set true to archive the table (hides it from default List Tables results), false to restore it.
string
required
The table’s ID.
string ("private" | "shared")
New table visibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_UPDATE_CONTACTS_TABLERename, archive, restore, or change the visibility of a contacts table.

Input Parameters

string
New table name.
object
required
Identifies the user acting on the table, and resolves to a user on your account. Required on every table-route call when authenticating with an API key (there is no signed-in user) - omitting it returns 400. Optional for OAuth/token callers, since the caller is already identified by the token; still accepted if you want to act on behalf of another owner.
boolean
Set true to archive the table (hides it from default List Tables results), false to restore it.
string
required
The contacts table ID.
string ("private" | "shared")
New table visibility.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: LUSHA_UPDATE_SUBSCRIPTIONUpdate a webhook subscription’s name, URL, active status, or signal types, or regenerate its secret. Unavailable with managed Lusha connections.

Input Parameters

string
required
The unique identifier of the subscription to update.
string
New webhook URL.
string
New subscription name.
boolean
Enable or disable subscription.
array
New signal types to subscribe to.
boolean
Generate new webhook secret (secret will be returned in response).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not