add_to_suppression_list
ChatGPTAdd emails and/or company domains to the account's global suppression list (up to 5,000 per call; repeat for more). Values are normalised: emails lowercased, domains reduced to the bare domain. Already-listed values are skipped, so repeating a call is safe.
find_email
ChatGPTFind and verify one person's work email from their name and company domain: a known person is revealed directly; otherwise the company's email pattern is used and the address verified live. 1 credit only when a verified email is returned. Confirm with the user before spending credits.
find_person
ChatGPTOne call from a company domain to a contact: picks the best person on file (owners first, or restricted by seniorities / departments / job_titles; or a named person with first_name + last_name) and, with reveal=true (the default), reveals their verified email (1 credit; catch-all and already-owned people free) and optionally a direct dial (1 credit). reveal=false only selects. found=false carries a reason and, when the company is known, up to 5 alternates to reveal with reveal_contact. Confirm with the user before spending credits.
get_account
ChatGPTReturn the connected Coldlytics account: subscription state, credit balance, monthly search allowance and the permissions of this connection.
get_contact
ChatGPTReturn one owned contact by crm_contact_id, including every owned email and dial.
get_research_task
ChatGPTStatus, counts and delivered contacts of a research task by task_id.
get_reveal_run
ChatGPTProgress and results of a bulk reveal started with reveal_contacts: counts, credits spent, and the revealed contacts once finished.
get_search_options
ChatGPTList valid values for search filters: seniorities, departments, business categories, website technologies, website features, service offerings, credentials, hiring functions, languages, brands carried, or matching location names. Call before filtering by category, technology, brand or location.
launch_research
ChatGPTHave Coldlytics' research team find decision-makers with verified emails at 20+ companies (by domain), or contact details for 20+ named people. Books credits per contact requested, needs an active subscription, and takes 1–3 business days. Confirm with the user first.
list_contacts
ChatGPTList the contacts this account already owns (from reveals and research tasks) with their emails, dials and tags. Filter by tag, free text, seniority, department, job-title keywords or contact data, and set max_per_company (1 = one contact per business) to build a one-person-per-company list.
list_research_tasks
ChatGPTThe account's research tasks, newest first, optionally filtered by status.
list_suppression_list
ChatGPTRead the account's global suppression list: the emails or domains (one type per call) it already has or must not contact. Research tasks and searches with exclude_suppressed leave these out.
lookup_company
ChatGPTReturn one company's profile by website domain: categories, size, Google listing, technologies, website signals (features, service offerings, credentials, hiring, quality grade), branches and revealable people. found=false means the company is not in the database yet. Does not count against the monthly search allowance.
lookup_person
ChatGPTReturn the person on file for a known email address or LinkedIn profile URL (exactly one of the two): name, title, seniority, department, LinkedIn, location and company, plus whether an email or dial can be revealed. No credits; found=false means nobody with that identifier is on file.
remove_from_suppression_list
ChatGPTRemove emails and/or company domains from the account's global suppression list. Values not on the list are ignored.
reveal_contact
ChatGPTReveal one person's verified email (1 credit; catch-all emails are free) and optionally a direct dial (1 credit), returning them immediately and saving them to the account's Contacts. Use this for single people (call it once per person for a handful). Free if the account already owns the person, and still returns their email and dial. Confirm with the user before spending credits.
reveal_contacts
ChatGPTBulk only: start a background run that reveals many people (up to 500) by contact_id (1 credit per verified email, optional dials 1 credit each; owned people are free). It does not return emails directly: poll get_reveal_run with the run_id until status is completed. For one or a few people use reveal_contact instead, which returns the email and dial immediately. Confirm the credit spend with the user first.
search_companies
ChatGPTFind companies in the Coldlytics (Voyager) database by keywords and filters (location, ZIP/postal code, category, residential/commercial customer type for trades, technology, website features such as video or online booking, service offerings such as free estimates or financing, website quality score, credentials, hiring, languages, brands carried, number of locations, ad pixels, Google review count and rating, size, revenue). Returns company profiles with contact_count; use search_people or lookup_company to get the people.
search_people
ChatGPTFind people at companies in the Coldlytics database: owners, founders, managers and other decision-makers, filtered by location, industry/keywords, company size, customer type, website features and quality, service offerings, credentials, hiring, ad pixels, Google reviews, seniority, department or job title. Returns names, titles and companies; every result has a verified email on file, revealed with reveal_contact.