Save a lead list
argorant_create_listSave a search as a private lead list, or add people to a list the user already has. Use it to keep a search for a campaign or an export. It is free, shows no contact details and sends nothing. By default it saves the WHOLE search, so pass the same filters you counted or previewed with; when the user says "save them as a list" after a preview, they mean the whole search. Pass record_ids with only_these=true only when the user clearly wants just the people shown. To grow a list, pass its list_id and people already in it are skipped. "Add the rest" means the same search into the SAME list_id, then argorant_add_campaign_leads with that list again. Never create a second list for the rest; a call without list_id always creates a new list. A filter a list cannot use is refused with a message, never dropped. The list fills in the background and the call answers at once; adds to a list that is still filling wait their turn and are never dropped. Follow it with argorant_list_status, where a size still being counted shows as not known yet, never as 0. The answer's summary says how many people were added and how many were already there; tell the user. More in the docs at https://docs.argorant.com/docs/agents/tools#lists
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "argorant_create_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free text for the search, such as "dental clinics" or a person's job and place. A request such as "software companies selling to restaurants" is read as company_category and sells_to. Prefer the dedicated filters when you know them. | |
| city | No | Cities by name. A comma means any of them. | |
| name | No | Name of a new list. Leave it out when you pass list_id. | |
| state | No | States or provinces by name or code, such as Texas or TX. A comma means any of them. | |
| title | No | Job titles to find. A comma means any of them. Short forms work both ways, so CFO also finds Chief Financial Officer. | |
| gender | No | Gender, female or male, based on first name and country. Names used for both women and men are left out. Not available for lending audiences. | |
| radius | No | Distance around the place, between 0.5 and 500. | |
| country | No | Countries, or regions such as Europe, EMEA, DACH, Nordics, Benelux, APAC, LATAM, North America or GCC. A comma means any of them. Regions can overlap. Egypt is in both Middle East and Africa, Mexico is in both North America and LATAM, and Turkey counts as Middle East, not Europe. A person is counted once, even when several of the regions you name include their country. | |
| list_id | No | An existing list to add to, from argorant_list_lists or an earlier save. The search or the record_ids are added and people already in it are skipped. | |
| industry | No | Industries by name, such as Software or Hospitals and Health Care. A comma means any of them. | |
| keywords | No | Words that describe what the company does, such as fintech, MSP or freight forwarding. A comma means any of them. They match the company's name, tags, industry and description, not people's own skills, unless you set where keywords look to people or any. | |
| near_lat | No | Latitude of the place to search around. Use it with near_lon and radius. | |
| near_lon | No | Longitude of the place to search around. Use it with near_lat and radius. | |
| sells_to | No | Who the company sells to, used with company_category. One of restaurants, construction, dentists, salons, auto_repair, hotels, logistics, trades, retailers or smb. It finds the companies that sell, never their customers. | |
| geography | No | The same as country. Countries or regions such as Europe, DACH, Nordics or North America. | |
| has_email | No | true (the default) looks only at people with a work email, like every count, preview, export and list. false also includes people without one. | |
| has_phone | No | true keeps only people with a phone number on file. Phone numbers themselves are only shown when paid for. | |
| seniority | No | How senior the person is. Pick one or more. | |
| near_place | No | A place to search around, written out as a city or a postal code, for example Denver, Colorado or 10115 Berlin. Use it with radius. | |
| only_these | No | true saves only the people in record_ids instead of the whole search. Only when the user clearly wants just the people shown. | |
| record_ids | No | Ids of people from a preview. They are saved alone only with only_these=true, or added to the list given in list_id. | |
| departments | No | The person's department. Pick one or more. | |
| founded_max | No | Companies founded in this year or earlier, such as 2020. | |
| founded_min | No | Companies founded in this year or later, such as 2015. Companies whose founding year is not known are left out. | |
| radius_unit | No | Unit of the distance, miles (mi, the default) or kilometers (km). | |
| revenue_max | No | Largest yearly revenue in US dollars, such as 50M. | |
| revenue_min | No | Smallest yearly revenue in US dollars, such as 1M. A company counts when its revenue range overlaps yours. | |
| title_match | No | How a job title must match. words (the default) needs every word as a whole word, so Data does not match Database. exact needs the whole title to be one of the values, so CEO does not match Founder & CEO. contains finds the text anywhere, also inside a word, and is slower. | |
| company_name | No | Company names. A comma means any of them. Prefer company_domain when you know the website. | |
| exclude_city | No | Cities to leave out. A comma means any of them. | |
| has_linkedin | No | true keeps only people with a profile link. | |
| revenue_band | No | Yearly company revenue in US dollars, as bands. Pick one or more. | |
| technologies | No | Technologies the company uses, such as Shopify, HubSpot or AWS. A comma means any of them. | |
| country_match | No | Whose place a country means. person (the default) counts people by where they are based and leaves out people whose own place is not known. person_or_company also counts them by their company's country. | |
| employees_max | No | Largest number of employees, such as 500. | |
| employees_min | No | Smallest number of employees, such as 50. A company counts when its size range overlaps yours. | |
| exclude_state | No | States or provinces to leave out. A comma means any of them. | |
| exclude_title | No | Job titles to leave out, matched the same way as title. A comma means any of them. | |
| keyword_scope | No | Where keywords look. company (the default) looks only at what the company does: its name, tags, industry and description, so a search for MSP finds people at managed service providers. Use people only when the user wants people who have a skill themselves, such as people who know Python or Salesforce admins at any company; it looks only at the person's own skills and profile. any looks at both, plus job titles. Without a value, company is used. | |
| radius_target | No | Whose location counts. any (the default) is where the person is based, or where their company is when their own place is not known. person is only where the person is based, company only where their company is based. | |
| verified_only | No | Deprecated. It has no effect on the search and will be removed. Leave it out. | |
| company_domain | No | Company website domains, such as stripe.com. A comma means any of them. | |
| employee_range | No | Number of employees at the company: size bands (pick one or more), or one text value with a range like "1-500". | |
| industry_match | No | How industries match. any (the default) finds the industry anywhere in what the company is tagged with. primary only counts the company's main industry, so Software and Internet leaves out a retailer or a bank that also carries a software tag. | |
| snapshot_total | No | Only with only_these, the number of matches the search had when the user picked the people, kept with the list for reference. | |
| company_country | No | Countries or regions where the company has its head office, with the same names as country. Use it with country to get people in a country at companies based there. For people it works together with a list of company websites (company_domain) for now. | |
| exclude_country | No | Countries or regions to leave out, matched the same way as country. A comma means any of them. | |
| company_category | No | What kind of company sells, used with sells_to. One of software, payments, pos_payments, business_fintech, accounting_software, payroll_hr_software, formation, association, marketplace or investors. | |
| exclude_industry | No | Industries to leave out, matched the same way as industry. A comma means any of them. | |
| exclude_keywords | No | Words to leave out, matched the same way as keywords. A comma means any of them. | |
| exclude_seniority | No | Seniority levels to leave out. Pick one or more. | |
| exclude_assistants | No | On by default. A job title search leaves out assistant titles such as assistant to, executive assistant or personal assistant. Set it to false to keep them. The answer lists what it left out under applied_defaults, and a saved list keeps the setting. | |
| business_email_only | No | Only people whose email is at their company's own domain. Off unless you set it, so private addresses are left out only on request. When it is on, the answer says so under applied_filters. | |
| exclude_departments | No | Departments to leave out. Pick one or more. | |
| exclude_title_match | No | How the titles to leave out must match, with the same choices. When it is not set, the title choice is used. | |
| exclude_company_domain | No | Company website domains to leave out. A comma means any of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |