sales
Apollo.io CLI for Headless Automation
Use the Apollo.io CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
6 functions 6 read 0 write API key auth
Apollo.io CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Apollo.io CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Apollo.io CLI for Headless Automation
kosmokrator integrations:configure apollo --set api_key="$APOLLO_API_KEY" --enable --read allow --write ask --json
kosmo integrations:call apollo.apollo_search_contacts '{"q":"example_q","page":1,"per_page":1}' --json Discovery Before Execution
Agents and scripts can inspect Apollo.io docs and schemas before choosing a function.
kosmo integrations:docs apollo --json
kosmo integrations:docs apollo.apollo_search_contacts --json
kosmo integrations:schema apollo.apollo_search_contacts --json
kosmo integrations:search "Apollo.io" --json
kosmo integrations:list --json Useful Apollo.io CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
apollo.apollo_search_contacts | Read | q, page, per_page | Search for people in Apollo by name, email, or keyword. Returns a paginated list of contacts with profile details including name, title, company, email, phone, and social profiles. |
apollo.apollo_get_contact | Read | id | Retrieve full details for a specific contact in Apollo by their person ID. Returns comprehensive profile data including employment history, emails, phone numbers, and social profiles. |
apollo.apollo_enrich | Read | email, name | Enrich a contact by matching on email address and/or name. Returns enriched profile data including title, company, social profiles, and contact details. Provide at least an email or a name. |
apollo.apollo_list_organizations | Read | page, per_page | List organizations from your Apollo account. Returns paginated results with company details including name, website, industry, employee count, and revenue. |
apollo.apollo_get_organization | Read | id | Retrieve full details for a specific organization in Apollo by its ID. Returns comprehensive company data including industry, employee count, revenue, tech stack, locations, and key contacts. |
apollo.apollo_get_current_user | Read | none | Retrieve the authenticated Apollo user's profile. Returns account information including name, email, plan type, and credit usage. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.