Find New Accounts
find_new_accountsFull Description
Returns pipeline-generation accounts: companies your partners sell to that you could go after. Use when the user asks which companies their partners can introduce them to, for net-new or greenfield prospecting, or for accounts missing from their CRM.
'pipeline_type' classifies the account, not a deal stage. Every account falls into exactly one class, and each row reports its own under the same name.
Different filters narrow together and values within one filter are alternatives, so countries=["US","DE"] with employee_ranges=["201-500"] means in the US or Germany, and 201-500 employees. Partner tags are the exception, described on that parameter.
Do NOT use for overlap questions about accounts you already work; use find_overlapping_accounts_and_leads. Do NOT use to rank partners on a specific deal; use find_partner_recommendations.
If any partner name or the partner tag name resolves to zero or multiple matches, returns ClarificationRequired listing each unresolved value and its candidates; present them to the user and re-invoke with partner_ids or partner_tag_id.
Returns: A paginated list of accounts, each with the partners that count it as a customer. If pagination.has_more is true, tell the user how many more results exist and ask before fetching the next page.
On a free plan only the first page is available and paging is not offered, so has_more is false there even when total_count reports more matching accounts than came back.
An empty result has several possible causes (no partner sharing greenfield data, a free-tier plan, owner-scoped access, or the data not having rebuilt yet), so hedge rather than asserting the user has no new accounts. Data rebuilds every 2 to 24 hours depending on class and plan, so an account added to the CRM today can still appear as net_new.
net_new accounts have no account_id, since they are absent from your CRM; domain is their key.
Parameters (0 required, 15 optional)
account_domainstringSearch term matched against account name and domain. Used only when account_name is empty or absent.
nullaccount_namestringSearch term matched against account name and domain. Pass just the company name; strip trailing sales suffixes ('opp', 'opportunity', 'deal', 'account').
nullcountriesarrayFilter by headquarters country. ISO 3166-1 alpha-2 codes (US, GB, DE). Use GB for the United Kingdom. Country names and multi-country regions are rejected.
nullemployee_rangesarrayFilter by company size. An account matches if its employee count falls in any listed range.
nulllimitintegerNumber of records per page (1-10, default 10). Use page to reach further records.
10only_recommendedbooleanOnly return accounts with at least one high-impact partner.
FalsepageintegerPage number to retrieve (1-indexed, default 1).
1partner_idsarrayPartner organization UUIDs. Takes precedence over partner_names and skips fuzzy matching.
nullpartner_namesarrayPartner names. Only return accounts at least one of these partners sells to. Fuzzy matched. Pass several to cover a set of partners in one call. Each returned account still lists all of its partners, not just the filtered ones. Ignored if partner_ids is provided.
nullpartner_tag_idstringPartner tag UUID. Retry parameter; takes precedence over partner_tag_name and skips name resolution. Widens rather than narrows: combined with partner_ids or partner_names, accounts are returned for partners matching either filter, not only those matching both.
nullpartner_tag_namestringPartner tag name (fuzzy matched), e.g. 'Strategic' or 'Tier 1'. Only return accounts sold to by partners carrying that tag. Widens the partner filter the same way partner_tag_id does. If ClarificationRequired is returned, present the candidate tags and retry with partner_tag_id.
nullpipeline_typestringWhich class of pipeline-generation account to return. 'prospect': in one of your prospect populations, overlaps a partner's customers, and you have no open opportunity on it. 'net_new': a partner's customer that is absent from your CRM entirely. 'not_in_my_populations': a partner's customer that is in your CRM but in none of your populations; usually a population-rule gap rather than a missed deal. 'all' unions the three.
allreasoningstringA concise explanation (keep it under ~1000 characters) of why you selected this tool for the user's request: what in the prompt led you to choose it and what you expect the call to return. Strongly encouraged on every call.
nullsort_bystringHow to rank the accounts. 'recommended_partner_count' puts the accounts with the most high-impact partners first, and 'last_partner_customer_date' puts the most recently won partner customers first. Omit for the default, which is recommended_partner_count.
nullsort_orderstringSort direction ('asc' or 'desc'). Only used when sort_by is provided; defaults to descending.
null