Apollo

Search contacts, enrich leads, and trigger sequences via the Apollo.io REST API.

This tool talks directly to the Apollo.io REST API (https://api.apollo.io/api/v1) using your master API key. It covers the three highest-value sales-prospecting operations: finding people, enriching a single lead, and adding contacts to an outbound sequence.

What it does

The tool returns the raw Apollo JSON response as result (a JSON string) plus the HTTP status. Non-2xx responses are returned, not thrown, so you can inspect Apollo's error payload.

API key setup

1. Sign in to Apollo and go to Settings → Integrations → API.
2. Create an API key (a master API key is required for search and sequence operations).
3. Pass it as the apiKey input. The tool sends it as the x-api-key request header — Apollo's documented authentication scheme. No OAuth or token exchange is needed.

Note: people_search does not consume credits, but people_enrichment with revealPersonalEmails: true and add_to_sequence do consume Apollo credits.

Inputs

People-enrichment requires at least one strong identifier: email, or domain, or organizationName, or firstName+lastName.

Examples

Search for sales managers in California

operation:         people_search
qKeywords:         sales manager
personTitles:      sales manager,account executive
personLocations:   California
perPage:           25

Enrich a known lead

operation:         people_enrichment
firstName:         tim
lastName:          zheng
domain:            apollo.io

Add contacts to a sequence

operation:                     add_to_sequence
sequenceId:                    6512a1b2c3d4e5f6a7b8c9d0
contactIds:                    64f1...a1,64f1...a2
sendEmailFromEmailAccountId:   63ab...90

Output

{
  "result": "{ ...raw Apollo JSON response... }",
  "status": "200"
}

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.