KosmoKrator

sales

Apollo.io CLI for AI Agents

Use the Apollo.io CLI from KosmoKrator to call Apollo.io tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

6 functions 6 read 0 write API key auth
Submit Apollo.io feedback View package source

Apollo.io CLI Setup

Apollo.io can be configured headlessly with `kosmokrator integrations:configure apollo`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure apollo --set api_key="$APOLLO_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor apollo --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
api_key APOLLO_API_KEY Secret secret yes API Key
url APOLLO_URL URL url no Base URL

Call Apollo.io Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call apollo.apollo_search_contacts '{
  "q": "example_q",
  "page": 1,
  "per_page": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:apollo apollo_search_contacts '{
  "q": "example_q",
  "page": 1,
  "per_page": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities 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

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Apollo.io.

apollo.apollo_search_contacts

Read read

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.

Parameters
q, page, per_page

Generic CLI call

kosmo integrations:call apollo.apollo_search_contacts '{"q":"example_q","page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:apollo apollo_search_contacts '{"q":"example_q","page":1,"per_page":1}' --json

apollo.apollo_get_contact

Read read

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.

Parameters
id

Generic CLI call

kosmo integrations:call apollo.apollo_get_contact '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:apollo apollo_get_contact '{"id":"example_id"}' --json

apollo.apollo_enrich

Read read

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.

Parameters
email, name

Generic CLI call

kosmo integrations:call apollo.apollo_enrich '{"email":"example_email","name":"example_name"}' --json

Provider shortcut

kosmo integrations:apollo apollo_enrich '{"email":"example_email","name":"example_name"}' --json

apollo.apollo_list_organizations

Read read

List organizations from your Apollo account. Returns paginated results with company details including name, website, industry, employee count, and revenue.

Parameters
page, per_page

Generic CLI call

kosmo integrations:call apollo.apollo_list_organizations '{"page":1,"per_page":1}' --json

Provider shortcut

kosmo integrations:apollo apollo_list_organizations '{"page":1,"per_page":1}' --json

apollo.apollo_get_organization

Read read

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.

Parameters
id

Generic CLI call

kosmo integrations:call apollo.apollo_get_organization '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:apollo apollo_get_organization '{"id":"example_id"}' --json

apollo.apollo_get_current_user

Read read

Retrieve the authenticated Apollo user's profile. Returns account information including name, email, plan type, and credit usage.

Parameters
none

Generic CLI call

kosmo integrations:call apollo.apollo_get_current_user '{}' --json

Provider shortcut

kosmo integrations:apollo apollo_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

apollo.apollo_search_contacts

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.

Operation
Read read
Schema command
kosmo integrations:schema apollo.apollo_search_contacts --json
ParameterTypeRequiredDescription
q string yes Search query — a name, email address, company name, or keyword.
page integer no Page number for pagination (default: 1).
per_page integer no Number of results per page (default: 25, max: 100).

apollo.apollo_get_contact

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.

Operation
Read read
Schema command
kosmo integrations:schema apollo.apollo_get_contact --json
ParameterTypeRequiredDescription
id string yes The Apollo person ID (e.g., "63f3b1c2XXXXXXXXXXXX").

apollo.apollo_enrich

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.

Operation
Read read
Schema command
kosmo integrations:schema apollo.apollo_enrich --json
ParameterTypeRequiredDescription
email string no Email address to match (e.g., "[email protected]").
name string no Full name to match (e.g., "John Smith").

apollo.apollo_list_organizations

List organizations from your Apollo account. Returns paginated results with company details including name, website, industry, employee count, and revenue.

Operation
Read read
Schema command
kosmo integrations:schema apollo.apollo_list_organizations --json
ParameterTypeRequiredDescription
page integer no Page number for pagination (default: 1).
per_page integer no Number of results per page (default: 25, max: 100).

apollo.apollo_get_organization

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.

Operation
Read read
Schema command
kosmo integrations:schema apollo.apollo_get_organization --json
ParameterTypeRequiredDescription
id string yes The Apollo organization ID (e.g., "63f3b1c2XXXXXXXXXXXX").

apollo.apollo_get_current_user

Retrieve the authenticated Apollo user's profile. Returns account information including name, email, plan type, and credit usage.

Operation
Read read
Schema command
kosmo integrations:schema apollo.apollo_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.