n8n-nodes-apolloio

Official n8n node for Apollo.io – Search, enrich, and automate with Apollo’s sales intelligence API.

Why use this node?

• Plug and play: add Apollo enrichment or sequence management to your n8n flows in seconds.
• Fully certified for API best-practices.
• Secure credential handling & works with n8n’s cloud or self-hosted.

Compatibility:

• n8n v1.x and v2.x
• Node.js 18.10+

📦 Installation

Run in your n8n custom nodes environment:

npm install n8n-nodes-apolloio
# or
pnpm add n8n-nodes-apolloio
# or
yarn add n8n-nodes-apolloio

Activate custom nodes in n8n (Settings → Community Nodes, then add this package). See n8n docs for help.

🔐 Authentication

1. Obtain your Apollo.io API Key from the Apollo dashboard.
2. In your n8n instance, open the credentials manager and search for “Apollo.io API”.
3. Enter your API Key securely.

🎛 Node Operations Overview

This node supports the following resources and operations:

Sequences

Search

• Search sequences by (partial) name.
• Paginated.

Add Contacts

• Add contacts (by Apollo contact IDs) to a specific sequence.

Person

Enrich

• Get full Apollo data for a person using:
  • Email,
  • LinkedIn URL,
  • Apollo Person ID, or,
  • First name + last name + company domain
• Any single identifier or full name + domain required.

Bulk Enrich (People)

• Enrich up to 10 people at once (input as JSON array).

Search

• Search for people using extensive filters:
  • Job Titles, Keywords, Locations, Seniority
  • Organization details (Domain, Location, IDs, Employee Count, Revenue)
  • Contact Email Status

Organization

Enrich

• Enrich by company domain (org ID supported as well).

Bulk Enrich (Organizations)

• Enrich up to 10 organizations at once (input as JSON array).

Search

• Search for organizations using extensive filters:
  • Locations (Include/Exclude), Keywords, Name
  • Employee Count, Revenue Range
  • Funding (Latest Amount/Date, Total Amount)
  • Job Postings (Titles, Locations, Count, Date Ranges)

📝 Node Parameters

| Resource | Operation | Required Fields | |---------------|----------------|---------------------------------------------------------| | Sequence | Search | sequenceName (optional), page, perPage | | Sequence | Add Contacts | sequenceId (required), contactIds (CSV or JSON) | | Person | Enrich | See Person Enrich Identifiers | | Person | Bulk Enrich | peopleDetailsJson (JSON array, 1-10 items) | | Person | Search | page, perPage + optional filters (Titles, Location...) | | Organization | Enrich | organizationDomain (required), organizationId (opt) | | Organization | Bulk Enrich | organizationDomainsJson (JSON array, 1-10 domains) | | Organization | Search | page, perPage + optional filters (Revenue, Funding...) |

Person Enrich Identifiers

• Any ONE of:
  • Email
  • LinkedIn URL
  • Apollo Person ID
  • (First Name + Last Name + Company Domain)

🚀 Example Workflows

Enrich New CRM Contacts

1. Trigger: New sheet row/CRM webhook
2. Apollo Node: Resource=Person, Operation=Enrich, Email from Sheet
3. Salesforce/HubSpot Node: Update contact with response data

Batch Company Enrichment

1. Trigger: Schedule/CSV Import
2. Apollo Node: Resource=Organization, Operation=Bulk Enrich, paste domain array
3. Sheet/CRM Node: Update organization records with enriched fields

🛠 Troubleshooting

• Authentication failures: Check your API Key, and if the problem persists, test the credential using the “Test Credential” button in n8n.
• Rate limits: Apollo.io may throttle requests based on your plan. Check API response headers for x-minute-requests-left.
• Bulk Operations: API maxes batches to 10 records. For more, loop in batches via n8n’s SplitInBatches node.
• Debugging: Use n8n’s node error handling; errors are descriptive and indicate which item failed.

📚 Resources

• Apollo API Docs
• n8n Docs

🤝 Open Source & Issues

PRs and community contributions welcome! Please file issues with error output and usage example.

License

MIT

Maintainer

Drewl / tayoonabule

Let me know if you’d like workflow screenshots, more advanced use-case templates, or NPM-ready formatting!