enrich_organization
ChatGPTEnrich an organization/company using SalesQL. Use when the user asks for organization details, company domain, industry, size, website, logo, LinkedIn, or company profile data. Prefer linkedin_url, then organization_domain, then organization_name. Do NOT use for enriching people or contacts. This tool does not consume SalesQL credits.
enrich_organization_bulk
ChatGPTEnrich up to 100 organizations/companies in one SalesQL request. Use when the user asks to enrich a batch, list, CSV-like group, or multiple companies at once. Each organization should include a linkedin_url, organization_domain, or organization_name. Do NOT use for enriching people or contacts. This tool does not consume SalesQL credits.
enrich_person
ChatGPTLook up one business contact in SalesQL's B2B database for sales, recruiting or marketing outreach. Returns the professional profile (name, headline, current job title and company, work history, industry, city-level location, LinkedIn URL and profile photo URL) and the emails and phone numbers SalesQL holds for that professional. Use when the user wants the contact details of a specific professional. Identify the person by linkedin_url (preferred), email, or full name plus organization_name or organization_domain. Do NOT use for companies (call enrich_organization). Do NOT use to locate private individuals or to get anyone's contact details for personal, non-business purposes. Uses up to 1 SalesQL enrichment credit.
enrich_person_bulk
ChatGPTLook up 1 to 100 business contacts in SalesQL's B2B database in one request, for sales, recruiting or marketing outreach. Returns one result per item: the professional profile and the emails and phone numbers SalesQL holds for that professional, or an item-level error. Use when the user provides a list of professionals to enrich. Each item needs a linkedin_url, an email, or a full name plus organization_name or organization_domain. Do NOT use for companies (call enrich_organization_bulk). Do NOT use to locate private individuals or for personal, non-business purposes. Uses up to 1 SalesQL enrichment credit per person found; tell the user the estimate and wait for confirmation before calling.
get_account_status
ChatGPTReturn the current SalesQL account status for the authenticated credential: plan, available enrichment credits, next credit refresh, monthly included credits, role, rate limits, low-credit warnings and whether the account is suspended (banned). Use it before enrichment when the user asks about credits, plan, quota, balance, or whether they have enough credits. The email of the connected SalesQL account (account_email) is left out unless include_account_email is true: set it only when the user explicitly asks which SalesQL account or workspace is connected, for example to confirm they are using the right account, and do not repeat the email in answers about credits or plan. It still answers while an account is suspended, so use it to confirm a suspension another tool reported. This tool does not consume SalesQL credits.
get_email_verification_job
ChatGPTRead the progress and results of a bulk email verification job created by verify_emails_bulk. Use it with the 'job_id' that tool returned; it does not consume credits. While 'status' is 'queued' or 'processing', 'results' is empty: wait 'retry_after_seconds' and call again. When 'status' is 'completed', 'results' lists every address with its 'status' ('valid', 'invalid', 'catch_all' or 'unknown') and 'email_type', and 'credits_charged' is final. 'failed' means the job could not run and 'failed_not_credits' means the verification balance ran out while it was running: in both cases stop polling, tell the user and do not restart the job. Do NOT use for jobs created from the SalesQL dashboard: they are not visible here.
lookup
ChatGPTResolve the exact filter values for company_size, company_type, industry, country, or region before building a search_people or search_organizations request. Call lookup FIRST whenever you need to filter by any of those five categories — it returns the canonical {value, label} pairs for the requested type. 'q' is REQUIRED for industry, country and region (they are fuzzy-searched, never listed in full) and ignored for company_size and company_type. Each type feeds a named filter field. In search_organizations: company_size -> employee_ranges, company_type -> company_types, industry -> industries, country -> countries, region -> states_or_cities. In search_people the same values go to organization_employee_ranges, organization_company_types, industries or organization_industries, countries or organization_countries, and states_or_cities or organization_states_or_cities. ALWAYS pass 'value' (not 'label') to those filter fields. For industry, 'value' is a slug; for country and region it is an opaque UUID — treat both as opaque identifiers; never invent or translate them. This tool does not consume SalesQL credits.
search_organizations
ChatGPTFind companies matching name, LinkedIn company URL, location, industry, employee-count, company-type and founding-year filters. Returns firmographic summaries; it does not consume SalesQL credits. Use when the user wants to BUILD OR QUALIFY A LIST OF COMPANIES ('which SaaS companies in Spain have 51-200 employees?'), or to turn company criteria into the organization identifiers the people search needs. Do NOT use when the user already named one specific company and wants its full profile — call enrich_organization instead. Do NOT use to find PEOPLE: call search_people, which takes the same company criteria through its own organization filters. Call lookup FIRST to resolve valid values for countries, states_or_cities, industries, employee_ranges (lookup type 'company_size') and company_types (lookup type 'company_type') — never guess these identifiers. uuids, countries, states_or_cities, industries, employee_ranges and company_types accept a bare list of values or an {include, exclude} object; name, linkedin_urls and founded_years accept only their positive form. Omit any filter you have no values for — never send empty lists or empty ranges. 'is_total_accurate' is only reliable when page == 1. Contact counts are NOT part of a result: to learn who works at a match, pass its 'uuid' to search_people as organization_uuids. For one company's full firmographics, call enrich_organization: pass the result's 'linkedin_url' unchanged, or pass its 'website_domain' as 'organization_domain' (the parameter has a different name there).
search_people
ChatGPTFind professionals in SalesQL's B2B database for sales, recruiting or marketing prospecting, by job title, industry, company, location, experience and contact-availability filters. Returns profile summaries; emails and phones are masked (e.g. '...@company.com') and only show which contact data exists. This tool does not use credits. Do NOT use to locate private individuals or for personal, non-business purposes. Call lookup FIRST to resolve valid values for countries, organization_countries, states_or_cities, organization_states_or_cities, industries, organization_industries, organization_employee_ranges, and organization_company_types — never guess these identifiers. Each filter accepts a bare list of values or an {include, exclude} object; omit any filter you have no values for — never send empty lists or empty ranges. Filters combine with AND. Every organization_* filter matches people holding ANY current position at a qualifying organization; people often hold several open positions at once, so the primary organization shown in a result may not be the one that matched the filter. 'is_total_accurate' is only reliable when page == 1. To get the contact details of a specific match the user wants, call enrich_person with its 'linkedin_url' (or full_name plus organization name/domain when it has no LinkedIn URL).
verify_email
ChatGPTVerify whether ONE email address really exists and accepts mail. Use when the user wants to check an address before emailing it, exporting it or adding it to a campaign, typically after enrich_person returned it. Do NOT use to find or guess an address (call enrich_person) and do NOT call it once per address for a list (call verify_emails_bulk). Result 'status': 'valid' (mailbox exists and accepts mail), 'invalid' (the server rejected it), 'catch_all' (the domain accepts any address, so the mailbox cannot be confirmed; risky) or 'unknown' (mail servers missing or misbehaving; not verifiable right now). Costs 1 VERIFICATION credit, a balance separate from the enrichment credits; an address verified within the last 120 days is served from cache ('from_cache': true) and costs the same. The check can take up to 45 seconds. If the call fails without a clear answer (timeout, dropped connection, backend error), do NOT repeat it right away: the verification may have completed and been charged.
verify_emails_bulk
ChatGPTQueue a bulk verification job for 1 to 500 email addresses. Use when the user wants to verify a list before exporting it or launching a campaign. Do NOT use for a single address (call verify_email). The result is NOT immediate: this tool returns a 'job_id' with status 'queued'. Call get_email_verification_job with that job_id to read progress and, once 'completed', the per-address results; wait the 'retry_after_seconds' it returns between polls. Only ONE bulk job can run at a time per account through the API or MCP: if one is already running, poll it until it finishes before queuing another. Duplicates are removed, so 'n_emails' may be lower than the number sent. Costs 1 VERIFICATION credit per unique address, charged when the job completes, from a balance separate from the enrichment credits; an address with an invalid format rejects the whole request and nothing is charged. If the call fails without a clear answer (timeout, dropped connection, backend error), do NOT queue the same list again right away: the job may have been created and a second one would charge again.