import_leads
Import leads
Act · mcp:actApproval cardIrreversibleCalls a providerPrepares the import of the leads a target returns, with their email addresses, into a named batch. It opens an approval card: only the user's click imports, and it spends one lead credit per lead asked for.
Prepare the import of the leads a target returns, with their email addresses, into a named batch. It spends one lead credit per lead asked for, and cannot be undone — so it does NOT import: it opens an approval card, and only the user's click on it, here or in VibeSell, runs it. Count with estimate_lead_pool and show people with preview_lead_sample first. Needs an active plan.Example
Section titled “Example”The user says
Import 300 of these dentists into a batch called “Dentists FR — November”.
{ "name": "import_leads", "arguments": { "countries": ["FR"], "jobTitles": ["Chirurgien-dentiste"], "subIndustries": ["Medical Practice"], "headcountMin": 2, "headcountMax": 50, "cohortName": "Dentists FR — November", "maxLeads": 300, "summary": "Import 300 dental practice owners in France" }}Arguments
Section titled “Arguments”countriesenum[]optionalone of 249 values≤ 20 itemsWhole countries to search, as ISO 3166-1 alpha-2 codes (FR, DE, US…). Each code covers the entire country. When the founder named a city or a region, it goes in places and its country stays out of this list.
placesobject[]optional≤ 20 itemsCities or regions (state, province…) the founder named, one object per place: [{"city": "Las Vegas", "region": "Nevada", "country": "US"}]. Give a city, a region or both, never neither. country is always the ISO 3166-1 alpha-2 code: work it out yourself when the founder only named the city. Write the names in full and in English, as on a map. Several places read as one OR the other.
citystringoptional1–80 charsregionstringoptional1–80 charscountrystringrequired2–2 chars
excludedPlacesobject[]optional≤ 20 itemsCities or regions to keep OUT of the search, in the same form as places. It only cuts a place out of a wider one, so it never comes alone: France except Paris is countries ["FR"] with excludedPlaces [{"city": "Paris", "country": "FR"}], and that country stays in countries. It leaves out the address locationScope names: under COMPANY, people who work in that city for a company registered elsewhere still come back, so to keep out the people there, as for a local practice or shop, use CONTACT. Even then a city left out is approximate, some people listed in it still come back, while a region left out holds: never promise the founder that no one from that city remains, and never swap the city for its region without their say.
citystringoptional1–80 charsregionstringoptional1–80 charscountrystringrequired2–2 chars
locationScope"CONTACT" | "COMPANY"optionalWhose address countries, places and excludedPlaces filter on: CONTACT for where the person themselves is, which is what prospects in a city means; COMPANY for where the company is registered, whose people may live elsewhere. It narrows nothing on its own and is ignored when no country and no place is given.
departmentsenum[]optionalone of 9 values≤ 20 itemsDepartments the champion works in.
ENGINEERINGFINANCE_AND_ADMINISTRATIONHUMAN_RESOURCESIT_AND_ISMARKETINGOPERATIONSSALESSUPPORTOTHER
seniorityLevelsenum[]optionalone of 13 values≤ 20 itemsHow senior the champion is.
jobTitlesstring[]optional1–80 chars≤ 20 itemsJob titles the champion holds, whenever the founder names a role (Head of Sales, dentiste, CFO…), written the way people of that market write it on their profile. A title matches every job title that contains it, and several titles read as one OR the other. A title nobody holds comes back as zero leads without any error: that zero is not an empty market, reword the title.
excludedJobTitlesstring[]optional1–80 chars≤ 20 itemsJob titles to keep OUT of the query, matched the same way: anyone whose job title contains one of them is left out, e.g. Intern or Assistant.
includedIndustriesenum[]optionalone of 20 values≤ 20 itemsIndustries to keep IN the query — everything else is left out.
excludedIndustriesenum[]optionalone of 20 values≤ 20 itemsIndustries to keep OUT of the query.
subIndustriesenum[]optionalone of 147 values≤ 20 itemsSub-industries to keep IN the query, for a niche narrower than an industry: Medical Practice rather than all of healthcare. Send them in place of includedIndustries, never with it: the provider adds a sub-industry to a whole industry instead of narrowing it, so both together search wider than either. Several sub-industries read as one OR the other.
excludedSubIndustriesenum[]optionalone of 147 values≤ 20 itemsSub-industries to keep OUT of the query.
revenueBandsenum[]optionalone of 8 values≤ 20 itemsYearly revenue brackets of the target companies, in US dollars. Several brackets read as one OR the other.
UP_TO_1MFROM_1M_TO_10MFROM_10M_TO_50MFROM_50M_TO_100MFROM_100M_TO_250MFROM_250M_TO_500MFROM_500M_TO_1BABOVE_1B
headcountBandsenum[]optionalone of 8 values≤ 20 itemsEmployee-count brackets of the target companies. headcountMin and headcountMax say the same with numbers of your own: use them instead, never both.
UP_TO_25FROM_25_TO_100FROM_100_TO_250FROM_250_TO_1000FROM_1K_TO_10KFROM_10K_TO_50KFROM_50K_TO_100KABOVE_100K
headcountMinintegeroptional≥ 1The fewest employees a target company may have, as a whole number, 1 or more: 500 for at least 500 employees. Use headcountMin and headcountMax in place of headcountBands, never both: given together, the brackets are refused and the numbers kept.
headcountMaxintegeroptional≥ 1The most employees a target company may have, as a whole number, 1 or more: 10 for up to 10 employees. Give it alone or with headcountMin, 11 and 50 for 11 to 50 employees.
technologiesstring[]optional1–80 chars≤ 20 itemsSoftware the target companies use, by product name (HubSpot, Shopify…), when the founder names a tool their buyers run. Several read as one OR the other. A name the provider does not know comes back as zero leads without any error: that zero is not an empty market.
companyWebsitesstring[]optional1–80 chars≤ 20 itemsWebsites of the very companies to search, as bare domains (acme.com: no https://, no path), only when the founder names those companies: nobody else comes back. A domain the provider does not hold comes back as zero leads without any error.
lookAlikeWebsitestringoptional1–80 charsThe website of ONE company the founder holds up as the model of their target, as a bare domain (alan.com): the query returns companies like it. Leave it out when they named no such company.
fundingStagesenum[]optionalone of 17 values≤ 20 itemsFunding rounds the target companies have raised. A company that never raised matches none of these, so a stage filter silently drops bootstrapped markets.
companyEventsenum[]optionalone of 24 values≤ 20 itemsRecent company news to require, e.g. HIRES or RECEIVES_FINANCING. The provider gives no date for these, so never tell the founder how recent they are.
keywordsstring[]optional1–80 chars≤ 20 itemsWords the target COMPANY is found by, in its name or in the description of what it does, never in the person's job title: ["orthodontie"] finds orthodontic practices. Several read as one OR the other, so give each word its own item, in every language those companies describe themselves in: ["dentaire", "dental"]. Words written together in one item are searched as that exact phrase: "dentaire dental" is one rare phrase, not two words. A word no company is described by comes back as 0 without any error: that zero says nothing about their market, so try another word before concluding.
excludedKeywordsstring[]optional1–80 chars≤ 20 itemsWords that keep a company OUT when its name or its description holds one of them. Same form as keywords: one word or exact phrase per item.
hiringForstring[]optional1–80 chars≤ 20 itemsJobs the target companies are hiring for right now, written as their job postings title them: ["Sales Development Representative"]. A company that recruits for a role is growing, and this filters on its open positions, never on the job title of the person contacted. Several read as one OR the other. The provider files most postings under their English title, even outside English-speaking countries: give the English title, with the local one beside it, ["Dental Assistant", "Assistant dentaire"].
cohortNamestringrequired2–120 charsA short, recognizable name for this batch, so the founder finds the leads later.
maxLeadsintegerrequired1–1000000How many leads to import at most. It is also what the import costs: one lead credit for every lead asked for here, whatever comes back. Size it yourself from the goal the founder gave you — but when they named a quantity, pass exactly that number: never round it, never raise it, and never carry over a figure agreed earlier in the conversation.
summarystringrequired3–300 charsWhat is imported, in one sentence.
Input schema
{ "type": "object", "properties": { "countries": { "description": "Whole countries to search, as ISO 3166-1 alpha-2 codes (FR, DE, US…). Each code covers the entire country. When the founder named a city or a region, it goes in places and its country stays out of this list.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "AD", "AE", "AF", "AG", "AI", "AL", "AM", "AO", "AQ", "AR", "AS", "AT", "AU", "AW", "AX", "AZ", "BA", "BB", "BD", "BE", "BF", "BG", "BH", "BI", "BJ", "BL", "BM", "BN", "BO", "BQ", "BR", "BS", "BT", "BV", "BW", "BY", "BZ", "CA", "CC", "CD", "CF", "CG", "CH", "CI", "CK", "CL", "CM", "CN", "CO", "CR", "CU", "CV", "CW", "CX", "CY", "CZ", "DE", "DJ", "DK", "DM", "DO", "DZ", "EC", "EE", "EG", "EH", "ER", "ES", "ET", "FI", "FJ", "FK", "FM", "FO", "FR", "GA", "GB", "GD", "GE", "GF", "GG", "GH", "GI", "GL", "GM", "GN", "GP", "GQ", "GR", "GS", "GT", "GU", "GW", "GY", "HK", "HM", "HN", "HR", "HT", "HU", "ID", "IE", "IL", "IM", "IN", "IO", "IQ", "IR", "IS", "IT", "JE", "JM", "JO", "JP", "KE", "KG", "KH", "KI", "KM", "KN", "KP", "KR", "KW", "KY", "KZ", "LA", "LB", "LC", "LI", "LK", "LR", "LS", "LT", "LU", "LV", "LY", "MA", "MC", "MD", "ME", "MF", "MG", "MH", "MK", "ML", "MM", "MN", "MO", "MP", "MQ", "MR", "MS", "MT", "MU", "MV", "MW", "MX", "MY", "MZ", "NA", "NC", "NE", "NF", "NG", "NI", "NL", "NO", "NP", "NR", "NU", "NZ", "OM", "PA", "PE", "PF", "PG", "PH", "PK", "PL", "PM", "PN", "PR", "PS", "PT", "PW", "PY", "QA", "RE", "RO", "RS", "RU", "RW", "SA", "SB", "SC", "SD", "SE", "SG", "SH", "SI", "SJ", "SK", "SL", "SM", "SN", "SO", "SR", "SS", "ST", "SV", "SX", "SY", "SZ", "TC", "TD", "TF", "TG", "TH", "TJ", "TK", "TL", "TM", "TN", "TO", "TR", "TT", "TV", "TW", "TZ", "UA", "UG", "UM", "US", "UY", "UZ", "VA", "VC", "VE", "VG", "VI", "VN", "VU", "WF", "WS", "YE", "YT", "ZA", "ZM", "ZW" ] } }, "places": { "description": "Cities or regions (state, province…) the founder named, one object per place: [{\"city\": \"Las Vegas\", \"region\": \"Nevada\", \"country\": \"US\"}]. Give a city, a region or both, never neither. country is always the ISO 3166-1 alpha-2 code: work it out yourself when the founder only named the city. Write the names in full and in English, as on a map. Several places read as one OR the other.", "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string", "minLength": 1, "maxLength": 80 }, "region": { "type": "string", "minLength": 1, "maxLength": 80 }, "country": { "type": "string", "minLength": 2, "maxLength": 2 } }, "required": ["country"] } }, "excludedPlaces": { "description": "Cities or regions to keep OUT of the search, in the same form as places. It only cuts a place out of a wider one, so it never comes alone: France except Paris is countries [\"FR\"] with excludedPlaces [{\"city\": \"Paris\", \"country\": \"FR\"}], and that country stays in countries. It leaves out the address locationScope names: under COMPANY, people who work in that city for a company registered elsewhere still come back, so to keep out the people there, as for a local practice or shop, use CONTACT. Even then a city left out is approximate, some people listed in it still come back, while a region left out holds: never promise the founder that no one from that city remains, and never swap the city for its region without their say.", "maxItems": 20, "type": "array", "items": { "type": "object", "properties": { "city": { "type": "string", "minLength": 1, "maxLength": 80 }, "region": { "type": "string", "minLength": 1, "maxLength": 80 }, "country": { "type": "string", "minLength": 2, "maxLength": 2 } }, "required": ["country"] } }, "locationScope": { "description": "Whose address countries, places and excludedPlaces filter on: CONTACT for where the person themselves is, which is what prospects in a city means; COMPANY for where the company is registered, whose people may live elsewhere. It narrows nothing on its own and is ignored when no country and no place is given.", "type": "string", "enum": ["CONTACT", "COMPANY"] }, "departments": { "description": "Departments the champion works in.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "ENGINEERING", "FINANCE_AND_ADMINISTRATION", "HUMAN_RESOURCES", "IT_AND_IS", "MARKETING", "OPERATIONS", "SALES", "SUPPORT", "OTHER" ] } }, "seniorityLevels": { "description": "How senior the champion is.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "OWNER", "PARTNER", "EXECUTIVE", "CHIEF_OFFICER", "VICE_PRESIDENT", "DIRECTOR", "MANAGER", "SENIOR", "MID_SENIOR_LEVEL", "ASSOCIATE", "ENTRY_LEVEL", "INTERNSHIP", "UNPAID_INTERNSHIP" ] } }, "jobTitles": { "description": "Job titles the champion holds, whenever the founder names a role (Head of Sales, dentiste, CFO…), written the way people of that market write it on their profile. A title matches every job title that contains it, and several titles read as one OR the other. A title nobody holds comes back as zero leads without any error: that zero is not an empty market, reword the title.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "excludedJobTitles": { "description": "Job titles to keep OUT of the query, matched the same way: anyone whose job title contains one of them is left out, e.g. Intern or Assistant.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "includedIndustries": { "description": "Industries to keep IN the query — everything else is left out.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "AGRICULTURE_AND_MINING", "BUSINESS_SERVICES", "COMPUTERS_AND_ELECTRONICS", "CONSUMER_SERVICES", "EDUCATION", "ENERGY_AND_UTILITIES", "FINANCIAL_SERVICES", "GOVERNMENT", "HEALTHCARE_PHARMACEUTICALS_AND_BIOTECH", "MANUFACTURING", "MEDIA_AND_ENTERTAINMENT", "NON_PROFIT", "OTHER", "REAL_ESTATE_AND_CONSTRUCTION", "RETAIL", "SOFTWARE_AND_INTERNET", "TELECOMMUNICATIONS", "TRANSPORTATION_AND_STORAGE", "TRAVEL_RECREATION_AND_LEISURE", "WHOLESALE_AND_DISTRIBUTION" ] } }, "excludedIndustries": { "description": "Industries to keep OUT of the query.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "AGRICULTURE_AND_MINING", "BUSINESS_SERVICES", "COMPUTERS_AND_ELECTRONICS", "CONSUMER_SERVICES", "EDUCATION", "ENERGY_AND_UTILITIES", "FINANCIAL_SERVICES", "GOVERNMENT", "HEALTHCARE_PHARMACEUTICALS_AND_BIOTECH", "MANUFACTURING", "MEDIA_AND_ENTERTAINMENT", "NON_PROFIT", "OTHER", "REAL_ESTATE_AND_CONSTRUCTION", "RETAIL", "SOFTWARE_AND_INTERNET", "TELECOMMUNICATIONS", "TRANSPORTATION_AND_STORAGE", "TRAVEL_RECREATION_AND_LEISURE", "WHOLESALE_AND_DISTRIBUTION" ] } }, "subIndustries": { "description": "Sub-industries to keep IN the query, for a niche narrower than an industry: Medical Practice rather than all of healthcare. Send them in place of includedIndustries, never with it: the provider adds a sub-industry to a whole industry instead of narrowing it, so both together search wider than either. Several sub-industries read as one OR the other.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "Dairy", "Farming", "Fishery", "Food & Beverages", "Food Production", "Mining & Metals", "Paper & Forest Products", "Ranching", "Tobacco", "Alternative Dispute Resolution", "Animation", "Business Supplies and Equipment", "Design", "Environmental Services", "Events Services", "Executive Office", "Facilities Services", "Fund-Raising", "Graphic Design", "Human Resources", "Import and Export", "Individual & Family Services", "Information Services", "International Trade and Development", "Law Practice", "Legal Services", "Management Consulting", "Market Research", "Marketing and Advertising", "Outsourcing/Offshoring", "Professional Training & Coaching", "Program Development", "Public Relations and Communications", "Public Safety", "Security and Investigations", "Staffing and Recruiting", "Think Tanks", "Translation and Localization", "Writing and Editing", "Computer Games", "Computer Hardware", "Computer Networking", "Consumer Electronics", "Semiconductors", "Consumer Goods", "Consumer Services", "Education Management", "E-Learning", "Higher Education", "Primary/Secondary Education", "Research", "Oil & Energy", "Renewables & Environment", "Utilities", "Accounting", "Banking", "Capital Markets", "Financial Services", "Insurance", "Investment Banking", "Investment Management", "Venture Capital & Private Equity", "Defense & Space", "Government Administration", "Government Relations", "International Affairs", "Judiciary", "Law Enforcement", "Legislative Office", "Military", "Museums and Institutions", "Public Policy", "Alternative Medicine", "Biotechnology", "Health, Wellness and Fitness", "Hospital & Health Care", "Medical Devices", "Medical Practice", "Mental Health Care", "Pharmaceuticals", "Veterinary", "Automotive", "Aviation & Aerospace", "Chemicals", "Electrical/Electronic Manufacturing", "Furniture", "Industrial Automation", "Machinery", "Mechanical or Industrial Engineering", "Plastics", "Railroad Manufacture", "Shipbuilding", "Textiles", "Broadcast Media", "Media Production", "Motion Pictures and Film", "Music", "Newspapers", "Online Media", "Printing", "Publishing", "Civic & Social Organization", "Libraries", "Non-Profit Organization Management", "Philanthropy", "Political Organization", "Religious Institutions", "Arts and Crafts", "Nanotechnology", "Architecture & Planning", "Building Materials", "Civil Engineering", "Commercial Real Estate", "Construction", "Glass, Ceramics & Concrete", "Real Estate", "Apparel & Fashion", "Cosmetics", "Luxury Goods & Jewelry", "Retail", "Supermarkets", "Computer & Network Security", "Computer Software", "Information Technology and Services", "Internet", "Telecommunications", "Wireless", "Airlines/Aviation", "Logistics and Supply Chain", "Maritime", "Package/Freight Delivery", "Packaging and Containers", "Warehousing", "Transportation/Trucking/Railroad", "Entertainment", "Fine Art", "Gambling & Casinos", "Hospitality", "Leisure, Travel & Tourism", "Performing Arts", "Photography", "Recreational Facilities and Services", "Restaurants", "Sporting Goods", "Sports", "Wine and Spirits", "Wholesale" ] } }, "excludedSubIndustries": { "description": "Sub-industries to keep OUT of the query.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "Dairy", "Farming", "Fishery", "Food & Beverages", "Food Production", "Mining & Metals", "Paper & Forest Products", "Ranching", "Tobacco", "Alternative Dispute Resolution", "Animation", "Business Supplies and Equipment", "Design", "Environmental Services", "Events Services", "Executive Office", "Facilities Services", "Fund-Raising", "Graphic Design", "Human Resources", "Import and Export", "Individual & Family Services", "Information Services", "International Trade and Development", "Law Practice", "Legal Services", "Management Consulting", "Market Research", "Marketing and Advertising", "Outsourcing/Offshoring", "Professional Training & Coaching", "Program Development", "Public Relations and Communications", "Public Safety", "Security and Investigations", "Staffing and Recruiting", "Think Tanks", "Translation and Localization", "Writing and Editing", "Computer Games", "Computer Hardware", "Computer Networking", "Consumer Electronics", "Semiconductors", "Consumer Goods", "Consumer Services", "Education Management", "E-Learning", "Higher Education", "Primary/Secondary Education", "Research", "Oil & Energy", "Renewables & Environment", "Utilities", "Accounting", "Banking", "Capital Markets", "Financial Services", "Insurance", "Investment Banking", "Investment Management", "Venture Capital & Private Equity", "Defense & Space", "Government Administration", "Government Relations", "International Affairs", "Judiciary", "Law Enforcement", "Legislative Office", "Military", "Museums and Institutions", "Public Policy", "Alternative Medicine", "Biotechnology", "Health, Wellness and Fitness", "Hospital & Health Care", "Medical Devices", "Medical Practice", "Mental Health Care", "Pharmaceuticals", "Veterinary", "Automotive", "Aviation & Aerospace", "Chemicals", "Electrical/Electronic Manufacturing", "Furniture", "Industrial Automation", "Machinery", "Mechanical or Industrial Engineering", "Plastics", "Railroad Manufacture", "Shipbuilding", "Textiles", "Broadcast Media", "Media Production", "Motion Pictures and Film", "Music", "Newspapers", "Online Media", "Printing", "Publishing", "Civic & Social Organization", "Libraries", "Non-Profit Organization Management", "Philanthropy", "Political Organization", "Religious Institutions", "Arts and Crafts", "Nanotechnology", "Architecture & Planning", "Building Materials", "Civil Engineering", "Commercial Real Estate", "Construction", "Glass, Ceramics & Concrete", "Real Estate", "Apparel & Fashion", "Cosmetics", "Luxury Goods & Jewelry", "Retail", "Supermarkets", "Computer & Network Security", "Computer Software", "Information Technology and Services", "Internet", "Telecommunications", "Wireless", "Airlines/Aviation", "Logistics and Supply Chain", "Maritime", "Package/Freight Delivery", "Packaging and Containers", "Warehousing", "Transportation/Trucking/Railroad", "Entertainment", "Fine Art", "Gambling & Casinos", "Hospitality", "Leisure, Travel & Tourism", "Performing Arts", "Photography", "Recreational Facilities and Services", "Restaurants", "Sporting Goods", "Sports", "Wine and Spirits", "Wholesale" ] } }, "revenueBands": { "description": "Yearly revenue brackets of the target companies, in US dollars. Several brackets read as one OR the other.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "UP_TO_1M", "FROM_1M_TO_10M", "FROM_10M_TO_50M", "FROM_50M_TO_100M", "FROM_100M_TO_250M", "FROM_250M_TO_500M", "FROM_500M_TO_1B", "ABOVE_1B" ] } }, "headcountBands": { "description": "Employee-count brackets of the target companies. headcountMin and headcountMax say the same with numbers of your own: use them instead, never both.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "UP_TO_25", "FROM_25_TO_100", "FROM_100_TO_250", "FROM_250_TO_1000", "FROM_1K_TO_10K", "FROM_10K_TO_50K", "FROM_50K_TO_100K", "ABOVE_100K" ] } }, "headcountMin": { "description": "The fewest employees a target company may have, as a whole number, 1 or more: 500 for at least 500 employees. Use headcountMin and headcountMax in place of headcountBands, never both: given together, the brackets are refused and the numbers kept.", "type": "integer", "minimum": 1 }, "headcountMax": { "description": "The most employees a target company may have, as a whole number, 1 or more: 10 for up to 10 employees. Give it alone or with headcountMin, 11 and 50 for 11 to 50 employees.", "type": "integer", "minimum": 1 }, "technologies": { "description": "Software the target companies use, by product name (HubSpot, Shopify…), when the founder names a tool their buyers run. Several read as one OR the other. A name the provider does not know comes back as zero leads without any error: that zero is not an empty market.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "companyWebsites": { "description": "Websites of the very companies to search, as bare domains (acme.com: no https://, no path), only when the founder names those companies: nobody else comes back. A domain the provider does not hold comes back as zero leads without any error.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "lookAlikeWebsite": { "description": "The website of ONE company the founder holds up as the model of their target, as a bare domain (alan.com): the query returns companies like it. Leave it out when they named no such company.", "type": "string", "minLength": 1, "maxLength": 80 }, "fundingStages": { "description": "Funding rounds the target companies have raised. A company that never raised matches none of these, so a stage filter silently drops bootstrapped markets.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "ANGEL", "PRE_SEED", "SEED", "PRE_SERIES_A", "SERIES_A", "PRE_SERIES_B", "SERIES_B", "PRE_SERIES_C", "SERIES_C", "PRE_SERIES_D", "SERIES_D", "SERIES_E", "SERIES_F", "SERIES_G", "SERIES_H", "SERIES_I", "SERIES_J" ] } }, "companyEvents": { "description": "Recent company news to require, e.g. HIRES or RECEIVES_FINANCING. The provider gives no date for these, so never tell the founder how recent they are.", "maxItems": 20, "type": "array", "items": { "type": "string", "enum": [ "RECEIVES_FINANCING", "HIRES", "EXPANDS_OFFICES", "GOES_PUBLIC", "ACQUIRES", "RECOGNIZED", "CLOSES_OFFICES", "IS_DEVELOPING", "HAS_ISSUES", "PROMOTES", "OPENS_NEW_LOCATION", "RECEIVES_AWARD", "INVESTS_IN_ASSETS", "SIGNS_NEW_CLIENT", "INCREASES_HEADCOUNT", "INVESTS_IN_COMPANY", "INTEGRATES", "EXPANDS_FACILITIES", "SELLS_ASSETS", "IDENTIFIED_AS_COMPETITOR", "DECREASES_HEADCOUNT", "EXPANDS_EXISTING_OFFICES", "FILES_SUIT", "MERGES" ] } }, "keywords": { "description": "Words the target COMPANY is found by, in its name or in the description of what it does, never in the person's job title: [\"orthodontie\"] finds orthodontic practices. Several read as one OR the other, so give each word its own item, in every language those companies describe themselves in: [\"dentaire\", \"dental\"]. Words written together in one item are searched as that exact phrase: \"dentaire dental\" is one rare phrase, not two words. A word no company is described by comes back as 0 without any error: that zero says nothing about their market, so try another word before concluding.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "excludedKeywords": { "description": "Words that keep a company OUT when its name or its description holds one of them. Same form as keywords: one word or exact phrase per item.", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "hiringFor": { "description": "Jobs the target companies are hiring for right now, written as their job postings title them: [\"Sales Development Representative\"]. A company that recruits for a role is growing, and this filters on its open positions, never on the job title of the person contacted. Several read as one OR the other. The provider files most postings under their English title, even outside English-speaking countries: give the English title, with the local one beside it, [\"Dental Assistant\", \"Assistant dentaire\"].", "maxItems": 20, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 80 } }, "cohortName": { "type": "string", "minLength": 2, "maxLength": 120, "description": "A short, recognizable name for this batch, so the founder finds the leads later." }, "maxLeads": { "type": "integer", "minimum": 1, "maximum": 1000000, "description": "How many leads to import at most. It is also what the import costs: one lead credit for every lead asked for here, whatever comes back. Size it yourself from the goal the founder gave you — but when they named a quantity, pass exactly that number: never round it, never raise it, and never carry over a figure agreed earlier in the conversation." }, "summary": { "type": "string", "minLength": 3, "maxLength": 300, "description": "What is imported, in one sentence." } }, "required": ["cohortName", "maxLeads", "summary"]}Result
Section titled “Result”Result kindapproval
kind"approval"status"pending" | "done" | "not_done" | "rejected"pending: waits for the user's click. done: approved and carried out. not_done: approved but refused when run. rejected: the user said no.
approvalobjectidstringactionstringsummarystringimpactstringirreversiblebooleanexpiresAtstring
outcomestring | nullWhat happened once decided, in a sentence.
decideHerebooleanTrue when the card shows Approve and Reject; otherwise the user decides in VibeSell.
appUrlstringWhere the user approves or rejects it in VibeSell.
Output schema
{ "type": "object", "properties": { "kind": { "type": "string", "const": "approval" }, "status": { "type": "string", "enum": ["pending", "done", "not_done", "rejected"], "description": "pending: waits for the user's click. done: approved and carried out. not_done: approved but refused when run. rejected: the user said no." }, "approval": { "type": "object", "properties": { "id": { "type": "string" }, "action": { "type": "string" }, "summary": { "type": "string" }, "impact": { "type": "string" }, "irreversible": { "type": "boolean" }, "expiresAt": { "type": "string" } }, "required": ["id", "action", "summary", "impact", "irreversible", "expiresAt"], "additionalProperties": false }, "outcome": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "What happened once decided, in a sentence." }, "decideHere": { "type": "boolean", "description": "True when the card shows Approve and Reject; otherwise the user decides in VibeSell." }, "appUrl": { "type": "string", "description": "Where the user approves or rejects it in VibeSell." } }, "required": ["kind", "status", "approval", "outcome", "decideHere", "appUrl"], "additionalProperties": false}Good to know
Section titled “Good to know”- maxLeads is also the cost: one lead credit per lead asked for, whatever comes back. An import cannot be undone.
- Needs an active plan.
- Count with estimate_lead_pool and show people with preview_lead_sample first.