Apollo

Use Apollo as the default high-recall people/company prospector.

Apollo is BYOK-only — it isn't resold on managed credits. Bring your own Apollo key; calls are free on Hyreflow (you pay Apollo directly).

Company vs CRM split

Method	Maps to	Use when
`apollo_company_search`	Organization Search (`mixed_companies/search`)	Find / resolve a company, search non-CRM companies
`apollo_search_accounts`	CRM Account Search (`accounts/search`)	Search accounts already in your Apollo CRM (stages, ownership)

Method	Maps to	Cost
`apollo_search_people`	`mixed_people/api_search`	Free, no Apollo credits — BYOK only

Keep include_similar_titles=true unless the user asks for strict title matching.
For broad discovery, start with person_seniorities + q_keywords, then tighten after inspecting totals.
When running company-targeted people search, pass q_organization_domains_list or organization_ids — avoid name-only keyword targeting.
Use low per_page for pilot checks, then scale once payload shape + match quality are confirmed.

hyreflow tools execute apollo apollo_search_people --dry-run \
  --payload '{"person_titles":["CTO"],"person_seniorities":["c_suite"],"per_page":5}'

For changed-company email recovery, don't force Apollo first — prefer the scenario default order from the people_search waterfall.