account_usage
ChatGPTLusha: returns current account credit usage (used, total, remaining). Use when: checking Lusha credit balance or quota before credit-consuming operations (contacts_search, companies_search, enrich tools). Do not use when: looking up rate limit information (rate limits are tracked separately from credit quota). Returns: Lusha credit usage summary. Credits: does not consume credits.
companies_search
ChatGPTLusha: looks up known companies in the Lusha database by name, domain, or FQDN (batch of 1-100). Use when: fetching specific known companies by name or domain. Do not use when: searching for companies by criteria like industry or size (prospecting_company_search covers that case). Returns: Lusha company profiles with available firmographic data. Credits: consumes Lusha credits per successful lookup. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
connect_crm
ChatGPTLusha: generates a secure OAuth link the user opens to connect (or reconnect) their CRM — Salesforce, HubSpot, and other supported CRMs — to Lusha. Connecting unlocks exporting records to the CRM, "in my CRM" / "not in my CRM" filtering, and CRM enrichment, so treat it as the gateway to every CRM feature. Use when: the user wants to connect, link, set up, reconnect, re-authorize, or "add" a CRM; says their CRM is disconnected, expired, or "not working"; or is trying to export or use any CRM feature but has no active connection. Proactively offer it the moment a CRM action is blocked by a missing or expired connection. Do not use when: the user only wants to see which CRMs are supported or check their connection status (use get_supported_integrations), or wants to export records (use the CRM export tools). Admin-only: if the user isn't an admin, return the message asking them to have their account admin connect it — do not generate a link. Present the returned redirectUrl as a clickable link — the OAuth flow completes in the browser, not in chat. Expired or invalid connections re-trigger the same flow; the URL is always fresh. Returns: redirectUrl to open in the browser to complete OAuth. Credits: does not consume credits.
contacts_enrich_job_list
ChatGPTLusha prospecting: lists the account's recent background contact-enrichment jobs, newest first. Use when: a background enrichment was started earlier and its job id is no longer to hand. Do not use when: the job id is known (contacts_enrich_job_status reports one job directly), or no enrich response has carried a job block in this session. Takes no arguments and reports scalars only; jobs[].jobId feeds contacts_enrich_job_status and contacts_enrich_job_results. An account with nothing running returns an empty jobs array rather than an error. Jobs stay listed for about 3 hours after the enrich request that created them, ordered by most recent activity. Returns: requestId, jobCount, activeJobCount and jobs[] with jobId, status, requestId, createdAt, expiresAt, contactCount and outstandingCount. No contact data. Credits: does not consume credits.
contacts_enrich_job_status
ChatGPTLusha prospecting: returns progress counts for a background contact-enrichment job, with no contact data. Use when: a prior enrich response carried a job block and the question is whether its outstanding reveals have landed yet. Do not use when: the enriched contacts themselves are wanted (contacts_enrich_job_results returns them), or the enrich response carried no job block, which makes it already final. Prerequisite: a job id from the job.id field of a prospecting_contact_enrich or contacts_search response. isTerminal false with pollAgainInSeconds set describes a job still running; isTerminal true means the data is final and later reads return the same body. pollsRemainingBeforeExpiry counts the reads that fit before the nominal 3-hour expiry at the returned cadence; 0 alongside isTerminal false describes a job past that window whose store lease keeps sliding, so one more read can still succeed. creditsCharged is the running total for the whole enrich request, synchronous reveals included, rather than a background-only increment. Returns: jobId, requestId, status, isTerminal, pollAgainInSeconds, secondsUntilExpiry, pollsRemainingBeforeExpiry, pastExpiry, contactCount, contactsWithOutstanding, outstandingCount, outstandingByType, resolvedCount, notFoundCount, coversRemaining and creditsCharged. No emails, phones or profile data. Credits: does not consume credits.
contacts_search
ChatGPTLusha: looks up a single known business contact by name, company, LinkedIn URL, or email. Use when: fetching contact details for a specific known person. Do not use when: searching for multiple contacts by criteria (prospecting_contact_search covers that case). Returns: Lusha contact profile with available business data. Credits: consumes 1 Lusha credit per successful lookup. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
conversations_search
ChatGPTLusha Conversations: finds the account's recorded sales calls by keyword, date, participant, domain, or title. Use when: reading recorded Lusha calls and their summary, coaching, or chapters. Do not use when: prospecting new contacts or companies (prospecting_contact_search). 'query' searches spoken content and overrides the structural filters. detail 'full' adds coaching and chapters, capping pageSize at 5. Returns: conversations[] (id, title, date, participants, company, summary), page, and billing. Credits: consumes Lusha credits per block of conversations returned; zero results cost nothing. account_usage carries the rate and the block size for this account and names this tool on it; no entry there means this account is not charged for it. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
conversations_transcript_get
ChatGPTLusha Conversations: returns the speaker-attributed transcript of one recorded call, in windows. Use when: the verbatim wording of a known recorded call is needed. Do not use when: the summary or coaching suffices (conversations_search covers those). Prerequisite: a conversation id from conversations_search. segmentOffset and segmentLimit window a long call into the budget. Returns: segments[] (speaker, side, text, startTime, endTime), segmentPage (offset, totalSegments, hasMore, nextSegmentOffset), and billing. Credits: consumes Lusha credits per request, including each additional window. account_usage carries the rate for this account and names this tool on it; no entry there means this account is not charged for it. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
export_companies_to_crm
ChatGPTLusha: exports known Lusha companies to the account's connected CRM, creating or updating the matching CRM records and returning per-company outcome, CRM link, and credits charged in one response. Use when: the user wants companies pushed, sent, exported, or synced into their CRM, from a search or enrichment run or from Lusha company ids they already hold. Do not use when: connecting or reconnecting a CRM (connect_crm); checking which CRMs are connected and their export limits (get_supported_integrations); or exporting contacts (export_contacts_to_crm). Prerequisite: Lusha company ids from a company search or enrich tool, and a connected CRM whose integrationName is passed as platform_name. User-scoped: OAuth sessions and member-owned API keys are accepted; account-wide API keys get a 403. An expired connection returns a 401 with redirectUrl, a fresh OAuth link; nothing is charged on that path and the export can be retried once it completes. An existing CRM record is always updated with Lusha data: the upstream accepts only UPDATE_ORIGINAL, so there is no duplication setting to pass. Returns: exportId, total, exported and failed counts, results[] (companyId, status of exported / already_exists / failed, crmLink, error), and billing.creditsCharged. Credits: consumes Lusha export credits per company the CRM actually writes; companies already present and left unchanged cost nothing. The amount charged comes back as billing.creditsCharged on the same response. account_usage does not quote an export rate today. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
get_supported_integrations
ChatGPTLusha: returns every CRM Lusha supports (both connected and not), each with its live connection state and export limits. Useful as a first step in any connect-or-export flow: it shows whether to connect or go straight to export, and which connection to use when more than one exists. Use when: the user asks which CRMs Lusha supports or integrates with; whether they're connected and to which CRM ("is my Salesforce still connected?", "which CRMs do I have linked?"); or what their export limits are. Also useful before offering or starting any CRM export to determine the connect-vs-export path, and right after a connection completes to confirm state. Do not use when: connecting a CRM (connect_crm); or exporting contacts/companies (use the CRM export tools). Returns ALL supported platforms, not only connected ones — read isAccountConnected / isUserConnected for connection state. Requires an OAuth (user-scoped) session; API-key callers get a 403. Returns: data[]: integrationName, instanceUrl, status, isAccountConnected, isUserConnected, supportedObjects, exportContactLimits, exportCompanyLimits, createdAt, updatedAt. Credits: does not consume credits.
icp_filters_get
ChatGPTLusha: returns the account and persona criteria a Target Profile supports, each with its legal values, plus the account's intent topics and the Lusha-based exclusion options. Use when: grounding targeting language in valid criteria and values before reading or changing a Lusha Target Profile. Do not use when: resolving filter values for a one-off prospecting search (prospecting_company_filters and prospecting_contact_filters cover that case). Account criteria describe the companies to target; persona criteria describe the people. A criterion whose values are not listed inline returns a lookup path to search with a query term. Intent topics are only those already chosen for the account in the Lusha platform; the list is empty when there are none. The response carries profile_questions: the order a profile is settled with the user, one question at a time — account criteria, each persona, intent topics, then Lusha-based exclusions. Only these criteria are accepted. Member-owned API keys allowed; account-wide keys get 403. Returns: the criteria for each half of a profile, each with its valid values or where to look them up, the account intent topics, the Lusha-based exclusion options, profile limits and profile_questions. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
icp_fit_score_companies
ChatGPTLusha: scores known companies against 1-3 of the caller's ICP Hub Target Profiles and returns how well each fits (batch of 1-100). Use when: checking how well specific companies match the caller's own ICP, not just whether they show real-world momentum; scoring a batch of known companies against Target Profiles already defined in ICP Hub; or building ICP-based prioritization or routing on the caller's own account list. Do not use when: real-world momentum is wanted instead of ICP match (signal_score_companies), full firmographic details are needed (prospecting_company_enrich), new companies that fit a profile are wanted (recommendations_companies), or the caller has no Target Profile at all: the call errors and points to ICP Hub, with no fallback score. Prerequisite: the Target Profile ids, listed by icp_profiles_get. One identifier per entry: id, domain, name, or email. A score of 0 means the company fits none of the profiles; it is a real answer and is billed. Account-wide API keys can score against shared profiles only. Common sequence: this tool, then signal_score_companies, then prospecting_company_enrich for the top-fit, high-signal subset. Together the two scores make up the in-app Score: the overall fit of a lead for the caller's business, 0-1. Returns: results[] per company (id, name, domain, icpFitScore 0-1 and topProfile for the best match, profileScores per profile when more than one is requested, or error) and billing. icpFitScore is how closely the company matches the caller's ideal customer, where higher means a closer match; the app shows it as ICP fit score. Credits: consumes Lusha credits per scored company, including a score of 0; see billing.creditsCharged. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
icp_profile_create
ChatGPTLusha: creates a Target Profile from account and persona criteria, and by default activates it. Use when: setting up Lusha targeting for an account that has none, or adding a further profile alongside the existing ones. Do not use when: changing a profile that already exists (icp_profile_update and icp_profile_status_set cover that case). An active profile changes every recommendation the account receives from then on. Criterion keys and values come from icp_filters_get; anything else is refused with the valid options named. A criterion left unset is not targeted, so a profile setting only a few matches broadly; profiles are usually settled with the user one criterion at a time, account criteria first and then each persona. Intent topics (intent_topics) and Lusha-based exclusions (lusha_exclusions) are steps of a profile like the criteria, each settled with the user; CRM exclusions are set in the Lusha platform. Weighting per criterion is the Lusha platform default and cannot be set. Sharing across the account is admin-only and affects every user on it. Limits: 10 profiles per user, 10 shared per account, 4 personas and 1 account criteria set per profile. Member-owned API keys allowed; account-wide keys get 403. Returns: the created profile, including its id and a link to it in the Lusha platform. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
icp_profile_delete
ChatGPTLusha: permanently deletes a Target Profile and stops the recommendations it drives. Use when: removing Lusha targeting that is no longer wanted at all. Do not use when: pausing targeting temporarily (icp_profile_status_set keeps the criteria and is reversible). Irreversible: the criteria and personas are gone with it. Refused while it is the only active profile on the account, since recommendations would stop. A profile owned by someone else cannot be deleted unless the caller is an account admin. Member-owned API keys allowed; account-wide keys get 403. Returns: deleted: true once the profile is gone. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
icp_profile_status_set
ChatGPTLusha: activates or pauses a Target Profile without changing its criteria. Use when: pausing the targeting behind Lusha recommendations, or resuming a profile that was paused earlier. Do not use when: removing a profile for good (icp_profile_delete covers that case). Pausing is reversible and keeps the criteria; the profile stops feeding recommendations while disabled. Recommendations stop altogether when the account has no other active profile. A profile already in the requested state needs no call. Member-owned API keys allowed; account-wide keys get 403. Returns: the profile with its new status. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
icp_profile_update
ChatGPTLusha: changes the name, sharing, criteria, personas, intent topics or exclusions of an existing Target Profile. Use when: refining the targeting behind Lusha recommendations that are returning the wrong kind of company or contact. Do not use when: only pausing or resuming a profile (icp_profile_status_set covers that case). Prerequisite: the profile configuration read through icp_profiles_get, since criteria are replaced rather than merged. Only the fields passed change; supplying a set of personas, or the account criteria, replaces that set in full. An update cannot leave a profile with no criteria. Intent topics and Lusha exclusions change only when passed, each list replacing the stored one; CRM exclusions are set in the Lusha platform and left untouched. A shared profile affects everyone on the account. Member-owned API keys allowed; account-wide keys get 403. Returns: the updated profile in the same shape icp_profiles_get returns for one profile. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
icp_profiles_get
ChatGPTLusha: lists the account Target Profiles, or returns one profile configuration in full when given its id. Use when: answering what targeting a Lusha account has configured, or why particular recommendations are appearing. Do not use when: fetching recommended companies or contacts (recommendations_companies and recommendations_contacts cover that case). Without profile_id the response lists every visible profile; with it the response carries that profile's criteria and personas. Profiles shared by an admin appear alongside the caller's own. The id comes from the list response, not from the user. Member-owned API keys allowed; account-wide keys get 403. Returns: the visible profiles, or one profile with its account criteria, personas, weighting and platform link. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
lookalike_companies
ChatGPTLusha: discovers companies similar to seed companies; returns paginated lookalike candidates. Use when: expanding a target account list with companies matching known good-fit profiles. Requires 5-100 seeds. Do not use when: looking up specific known companies (companies_search) or filtering by criteria (prospecting_company_search). Returns: lookalike companies (employees, industry, location), dedupeSessionId, meta.hasMore, and credit charge. Re-use dedupeSessionId for non-duplicate follow-up calls; sessions expire after 30 days. Credits: consumes Lusha credits per request. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
lookalike_contacts
ChatGPTLusha: discovers contacts similar to seed contacts; returns paginated lookalike candidates. Use when: expanding a prospect list with contacts matching known good-fit profiles. Requires 5-100 seeds. Do not use when: looking up specific known contacts (contacts_search) or filtering by structured criteria (prospecting_contact_search). Returns: lookalike contacts plus dedupeSessionId for pagination, meta.hasMore, and credit charge. Re-use the returned dedupeSessionId for non-duplicate follow-up calls; sessions expire after 30 days. Credits: consumes Lusha credits per request. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
prospecting_company_enrich
ChatGPTLusha prospecting: reveals full firmographic details for companies from a prior prospecting_company_search. Requires company IDs and the requestId (UUID) returned by that search. Use when: fetching full firmographic data for companies returned by a prior prospecting_company_search. Do not use when: no prior prospecting_company_search exists, or identity is unknown (companies_search covers direct lookups). 'requestId' + 'ids' must pair from the same recent search; stale/fake values return 400. Returns: enriched Lusha company profiles. Credits: consumes Lusha credits per enriched company. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
prospecting_company_filters
ChatGPTLusha: resolves valid filter values accepted by prospecting_company_search. Use when: resolving valid filter values before calling prospecting_company_search. Do not use when: looking up specific known companies (companies_search covers that case). No-query filter types: sizes, revenues, industries_labels, intent_topics. Query-narrowed filter types: names, locations, technologies, sics, naics (sics/naics responses can be large; the "q" parameter reduces response size). Resolves one filter type per call. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
prospecting_company_search
ChatGPTLusha prospecting: finds companies by filters (industry, size, revenue, location, technologies). Use when: finding multiple companies by criteria. Do not use when: looking up a specific known company (companies_search covers that case). Prerequisite: valid values for sizes/revenues/sics/naics/industries/locations/technologies are returned by prospecting_company_filters. 'searchText' is a relevance hint, not an exact filter. Returns: paginated Lusha companies. prospecting_company_enrich returns full firmographic details for selected IDs. Credits: may consume Lusha credits per request. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
prospecting_contact_enrich
ChatGPTLusha prospecting: reveals emails and phones for contacts from a prior prospecting_contact_search. Requires contact IDs and the requestId (UUID) returned by that search. Use when: fetching emails/phones for contacts returned by a prior prospecting_contact_search. Do not use when: no prior prospecting_contact_search exists, or identity is unknown (contacts_search covers direct lookups). 'requestId' + 'ids' must pair from the same recent search; stale/fake values return 400. Returns: enriched Lusha contact profiles with emails and phones. Credits: consumes Lusha credits per enriched contact. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
prospecting_contact_filters
ChatGPTLusha: resolves valid filter values accepted by prospecting_contact_search. Use when: resolving valid filter values before calling prospecting_contact_search. Do not use when: looking up specific known contacts (contacts_search covers that case). No-query filter types: departments, seniority, all_countries, existing_data_points. Requires "locationSearchText": locations. Resolves one filter type per call. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
prospecting_contact_search
ChatGPTLusha prospecting: finds business contacts by filters. Requires at least one contact-side filter. Use when: finding multiple contacts by criteria. Do not use when: looking up a specific known contact (contacts_search covers that case). Prerequisite: valid values for departments/seniority/countries/locations are returned by prospecting_contact_filters. 'searchText' is a relevance hint, not an exact filter. Returns: paginated Lusha contacts. prospecting_contact_enrich returns emails and phones for selected IDs. Credits: may consume Lusha credits per request. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429.
recommendations_companies
ChatGPTLusha: the account list this user should work next - their own companies, ranked. Personalised to their active ICP target profiles and scored on live buying signals. Call it with no arguments. Use when: the user asks what to work on without naming criteria of their own - "who should I go after today", "which accounts should I prioritise", "give me my best accounts", "what's worth my time this week", "find me good-fit companies", "any warm accounts". Also the right opening move for a vague targeting ask, where this user's own ICP is a better filter than a guessed one. Do not use when: the user states the firmographic criteria to match (prospecting_company_search); names specific companies (companies_search); or brings a seed list to expand (lookalike_companies). If the user asks about people rather than accounts, recommendations_contacts covers it. No input required: every parameter is optional and an empty call returns the top-ranked page, sorted by lead score. recommendations_companies_filters (free) is only needed to filter by target profile or signal type - never invent those values. Each record carries leadScore, icpFitScore, signalScore, the signals that fired and the target profile matched, so you can tell the user WHY a company is on the list rather than just listing it. Auth: needs a member-owned (user-level) API key. An account-wide key returns 403 - say so plainly and offer prospecting_company_search instead. Returns: paginated recommended companies with scores, pagination, and billing. Credits: consumes Lusha credits per company returned, so pagination.size caps the cost; preview with size 10 before pulling a full page. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
recommendations_companies_filters
ChatGPTLusha: returns this user's own active ICP target profiles and the signal types available on company recommendations. Free - consumes no credits. Use when: the user asks what target profiles or ICPs they have set up; or when about to filter recommendations_companies by profile or signal and the real ids are needed. Safe to call speculatively - it costs nothing. Do not use when: the user just wants the recommendations. recommendations_companies works with no arguments and does not require this call first. Auth: needs a member-owned (user-level) API key; an account-wide key returns 403. Returns: availableSignals (signal identifiers) and availableTargetIcps ({ id, name }). Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
recommendations_contacts
ChatGPTLusha: returns recommended contacts ranked by lead, signal, and ICP-fit scores. Use when: surfacing recommended contacts for the user; optional targetIcp, signals, or score filters. Do not use when: explicit-criteria search (prospecting_contact_search) or known contacts (contacts_search). Prerequisite: targetIcp and signal values come from recommendations_contacts_filters. OAuth-only: API key sessions receive a 403. Returns: paginated recommended contacts with scores, pagination, and billing. Credits: consumes 1 Lusha credit per non-error recommended contact returned. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
recommendations_contacts_filters
ChatGPTLusha: returns this user's own active ICP target profiles and the signal types available on contact recommendations. Free - consumes no credits. Use when: the user asks what target profiles or ICPs they have set up; or when about to filter recommendations_contacts by profile or signal and the real ids are needed. Safe to call speculatively - it costs nothing. Do not use when: the user just wants the recommendations. recommendations_contacts works with no arguments and does not require this call first. Auth: needs a member-owned (user-level) API key; an account-wide key returns 403. Returns: availableSignals (signal identifiers) and availableTargetIcps ({ id, name }). Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
report_event
ChatGPTReports a client-side BI event.
signal_score_companies
ChatGPTLusha signals: scores known companies by their currently active buying signals (batch of 1-50). Use when: prioritizing known companies by buying-signal activity (up to 50 by id, domain, name, or email). Do not use when: the signal events are needed (signals_companies_get), or discovering companies by criteria (prospecting_company_search). One identifier per entry: id, domain, name, or email. Returns: results[] per company (id, name, domain, signalScore, signalTypes, noActiveSignals, or error) and billing. Credits: consumes Lusha credits per scored company; see billing.creditsCharged. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signal_score_contacts
ChatGPTLusha signals: scores known contacts by their currently active buying signals (batch of 1-50). Use when: prioritizing known contacts by buying-signal activity (batch up to 50). Do not use when: the signal events are needed (signals_contacts_get), or resolving identifiers without a score (signals_contacts_search). One lookup path per entry: id, linkedinUrl, email, or name + company. Returns: results[] per contact (id, fullName, company, signalScore, signalTypes, noActiveSignals, or error) and billing. Credits: consumes Lusha credits per scored contact; see billing.creditsCharged. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signals_companies_get
ChatGPTLusha signals: returns recent activity signals (hiring, headcount, IT spend, news) for known Lusha company IDs (batch of 1-25). Use when: Lusha company IDs are known (e.g., from prospecting_company_search). Do not use when: only domain/name are available (signals_companies_search covers that case). Signal types and 'filters.include' values: signals_company_filters. Defaults: 6 months, 10 per type. Returns: results[] (one per company ID) with signal events, date window, and billing.creditsCharged. Credits: consumes Lusha credits per signal returned. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signals_companies_search
ChatGPTLusha signals: resolves companies by domain or name and returns recent activity signals (hiring, headcount, IT spend, news). Batch of 1-25. Use when: only company identifiers (domain or name) are available. Do not use when: Lusha company IDs are known (signals_companies_get covers that case). Each entry: caller 'id' plus name or domain. Defaults: 6 months, 10 per type. Optional 'filters.include' narrows news/hiring signals. Returns: results[] per caller id with signal events (or NOT_FOUND), date window, billing.creditsCharged. Credits: consumes Lusha credits per signal returned. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signals_company_filters
ChatGPTLusha signals: discovers company signal types and the filter directory, or returns values for a single filter when filterType is set. Use when: discovering company signal types and filters, or enumerating values for a filter type. Do not use when: looking up contact signal types (signals_contact_filters covers that case). Omit filterType for the directory; set it for values. 'hiringByLocations' requires 'query'. Returns: Directory: { signalTypes, availableFilters: [{ filterType, requiresQuery }] }. Values: { filterType, values }. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signals_contact_filters
ChatGPTLusha signals: returns the available contact signal types accepted by signals_contacts_get and signals_contacts_search. Use when: discovering which contact signal types are currently supported before requesting contact signals. Do not use when: fetching signals data for a contact (signals_contacts_get and signals_contacts_search return signals). Returns: list of supported contact signal type identifiers (e.g., promotion, companyChange, allSignals). Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signals_contacts_get
ChatGPTLusha signals: returns recent activity signals (promotions, company changes) for known Lusha contact IDs (batch of 1-25). Use when: Lusha contact IDs are known (e.g., from prospecting_contact_search or contacts_search). Do not use when: only LinkedIn URL/email/name+company are available (signals_contacts_search covers that case). Signal type values: see signals_contact_filters. Defaults when omitted: last 6 months, 10 per type per contact. Returns: results[] (one per contact ID) with signal events, date window, and billing.creditsCharged. Credits: consumes Lusha credits per signal returned. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
signals_contacts_search
ChatGPTLusha signals: resolves contacts by LinkedIn URL, email, or name+company and returns recent activity signals (promotions, company changes). Batch of 1-25. Use when: only contact identifiers (LinkedIn URL, email, or name+company) are available. Do not use when: Lusha contact IDs are known (signals_contacts_get covers that case). Each entry: caller 'id' plus social_link, email, or full_name+company. Defaults: 6 months, 10 per type. Returns: results[] per caller id with signal events (or NOT_FOUND), date window, billing.creditsCharged. Credits: consumes Lusha credits per signal returned. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_add_entities
ChatGPTLusha Workspace: adds known Lusha entity ids (contacts or companies) to a table; duplicates are deduped. Use when: adding specific Lusha ids from a prior search/enrich result into an existing table. Do not use when: searching-and-saving in one step (use a search tool) or removing rows (table_remove_entities). For contacts tables, pass company_ids index-aligned with entity_ids so the workspace can enrich each contact (person + company pair); ignored for companies tables. Returns: counts of added, alreadyPresent, and invalidIds, plus attribution. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_columns_catalog
ChatGPTLusha Workspace: lists every Lusha data column available to add to a contacts or companies table. Use when: choosing which columns to enrich a table with, or resolving a datapoint to the columnKey that table_add_columns takes. Do not use when: listing the columns a table already holds (table_list_columns) or reading row values (table_get_entities). Per entity_type and independent of any table; keys come back unprefixed ('jobTitle', not 'contact_jobTitle'). Returns: catalog entries (category, displayName, columnKey, type) for the entity type. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_create
ChatGPTLusha Workspace: creates an empty contacts or companies table to collect and enrich saved records. Use when: starting a new saved list/table before adding entities or writing search/enrich/signals results into it. Do not use when: a target table already exists (use its tableId directly with the entity/column tools). Set entity_type to match the records the table will hold ('contacts' or 'companies'); it cannot be changed later. Returns: the created table (tableId, name, entityType, visibility, owner, timestamps). Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_delete
ChatGPTLusha Workspace: deletes a table and its rows/columns. Use when: permanently removing a table the caller no longer needs. Do not use when: only hiding a table from active views (table_update with archived=true) or removing rows (table_remove_entities). Prerequisite: the target tableId comes from table_create or table_list. Returns: the deleted tableId and its terminal status. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_get_entities
ChatGPTLusha Workspace: reads a page of a table's rows, including populated column values. Use when: retrieving the saved/enriched records in a table after adds or column runs complete. Do not use when: checking run progress/aggregate counts (table_status) or listing columns (table_list_columns). Returns: a page of row objects (entity data + column values) plus pagination. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_list
ChatGPTLusha Workspace: lists the caller's contacts or companies tables with pagination and name/status filters. Use when: discovering existing tables or resolving a table name to its tableId. Do not use when: inspecting one table's row counts and column run progress (table_status covers that case). Returns: paginated tables (tableId, name, entityType, visibility, status, owner, timestamps) plus pagination. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_list_columns
ChatGPTLusha Workspace: lists a table's columns with per-status row counts. Use when: discovering the columns a table already has (and their columnId) before running or removing one. Do not use when: the columns available to add (table_columns_catalog); reading the row values themselves (table_get_entities). Prerequisite: the target tableId comes from table_create or table_list. Returns: columns (columnId, name, type, key, isDefault, timestamps) with per-status row counts. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_remove_column
ChatGPTLusha Workspace: removes a non-default column from a table. Use when: deleting a column that is no longer needed. Do not use when: removing rows (table_remove_entities) or deleting the table (table_delete). Default Lusha columns cannot be removed. Prerequisite: the target tableId comes from table_create or table_list. Returns: the removed columnId and a removed flag. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_remove_entities
ChatGPTLusha Workspace: removes rows (by Lusha entity id) from a table. Use when: pruning specific contacts or companies from a table. Do not use when: deleting the whole table (table_delete). Prerequisite: the target tableId comes from table_create or table_list. Returns: count of removed rows and any ids that were not present. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_run_column
ChatGPTLusha Workspace: runs (populates) a column across all, missing-only, or specific rows. Use when: populating or refreshing a column's values for existing rows. Do not use when: creating a new column (table_add_column) or reading results (table_get_entities / table_status). run_scope='specific' requires entity_ids. Runs are async - poll table_status for progress. Returns: the columnId, requested runScope, and the async run status. Credits: consumes Lusha credits per billable row the run populates. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_status
ChatGPTLusha Workspace: returns one table's entity count and per-column run aggregates (processing/success/failed rows). Use when: polling progress after running a column or saving results, or checking whether a table is still processing. Do not use when: browsing multiple tables (table_list) or reading row data (table_get_entities). Prerequisite: the target tableId comes from table_create or table_list. Returns: table metadata plus entityCount, isProcessing, and per-column rowsNotRun/Processing/Success/NoData/Failed. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
table_update
ChatGPTLusha Workspace: renames a table, changes its visibility, or archives/unarchives it. Use when: renaming a table, sharing it (visibility), or archiving/unarchiving it. Do not use when: permanently deleting a table (table_delete) or changing its rows/columns (entity/column tools). Prerequisite: the target tableId comes from table_create or table_list. Returns: the updated table record. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
website_visits_search
ChatGPTLusha: ranks companies that visited the account's tracked websites by visit engagement. Use when: ranking companies that recently visited the account's own tracked websites. Do not use when: finding companies by firmographic criteria (prospecting_company_search) or a known company (companies_search). domains, dates, and pagination are optional; defaults: all tracked sites, last 30 days (3-month max), 0-based page 0 / size 25. Returns: ranked companies with firmographic preview, visit metrics, per-result siteId/trackedDomain, and pagination with hasMore. Credits: does not consume credits. Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.
account_usage
Claudecompanies_search
Claudecontacts_search
Claudedecision_makers_search
Claudelookalike_companies
Claudelookalike_contacts
Claudeprospecting_company_enrich
Claudeprospecting_company_filters
Claudeprospecting_company_search
Claudeprospecting_contact_enrich
Claudeprospecting_contact_filters
Claudeprospecting_contact_search
Claudepurchase_options
Clauderecommendations_companies
Clauderecommendations_companies_filters
Clauderecommendations_contacts
Clauderecommendations_contacts_filters
Claudesignals_companies_get
Claudesignals_companies_search
Claudesignals_company_filters
Claudesignals_contact_filters
Claudesignals_contacts_get
Claudesignals_contacts_search
Claudewebsite_visits_search
Claude
