パッケージの詳細

n8n-nodes-apolloio

tayoonabule55MIT0.3.17

n8n node for Apollo.io - Search, Enrich, and Prospect People & Organizations via API

n8n-community-node-package, n8n, n8n-community, n8n-node

readme

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


🤝 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!

更新履歴

Changelog

All notable changes to this project will be documented in this file.

[0.3.17]

Fixed

  • Organization Search: Fixed a crash occurring when the API returns an unexpected response structure (e.g., missing organizations array). Added guards to safely handle undefined responses.
  • Person Search: Added similar guards to Person Search to prevent potential crashes on unexpected API responses.

Added

  • Organization Search: Added support for filtering by "Technologies Used" (currentlyUsingAnyOfTechnologyUids).
  • Person Enrichment: Added support for revealing personal emails and phone numbers via revealPersonalEmails and revealPhoneNumber parameters.
  • Person Enrichment: Added webhookUrl parameter, required when revealing phone numbers for asynchronous delivery.

[0.3.16]

Improved

  • Operation Descriptions: Added explicit descriptions to all operation options (Search, Enrich, Bulk Enrich, etc.) to help AI agents understand the purpose of each action.

[0.3.15]

Documentation

  • Developer Guide: Added CONTRIBUTING.md to document development standards, project architecture, and best practices for maintaining the node.
  • AI Guidelines: Explicitly documented requirements for keeping the node AI-agent friendly.

[0.3.14]

Meta

  • NPM Listing: Enhanced package metadata (keywords and description) to improve discoverability on npm and within n8n. Added tags for CRM, B2B, Lead Generation, and Marketing.

[0.3.13]

Improved

  • AI Agent Friendliness: Updated parameter descriptions to be more verbose and explicit, specifically detailing input formats (e.g., "semicolon separated") and providing context. This ensures LLMs and AI agents can correctly construct inputs for complex filters like locations, seniorities, and funding ranges.

[0.3.12]

Added

  • AI Agent Support: Added usableAsTool: true to node description, enabling the Apollo node to be used as a tool by AI agents in n8n.

[0.3.11]

Fixed

  • Configuration: Updated tsconfig.json to resolve TypeScript module resolution errors in development environments.

[0.3.10]

Documentation

  • README: Updated documentation to fully cover the new Person and Organization Search operations and their available filters.

[0.3.9]

Added

  • Organization Search: Added a new "Search" operation to the Organization resource to allow finding companies.
  • Organization Filters: Implemented extensive filtering capabilities including:
    • Employee Count and Revenue Ranges
    • Organization Locations (Include/Exclude)
    • Keywords and Name
    • Funding (Latest Amount, Total Amount, Dates)
    • Job Postings (Titles, Locations, Count, Date Ranges)

Internal

  • Refactoring: Created utils.ts and moved splitAndTrim helper function to be shared between Person and Organization logic.

[0.3.8]

Added

  • Person Search: Added a new "Search" operation to the Person resource to allow finding net new people.
  • Search Filters: Implemented extensive filtering capabilities including:
    • Job Titles and Keywords
    • Person and Organization Locations
    • Seniority Levels
    • Organization Domains and IDs
    • Employee Count and Revenue Ranges
    • Contact Email Status

Changed

  • Input Parsing: Enhanced list parameter handling to support semicolon separators and automatically filter out empty or invalid entries for more robust API requests.
  • Compliance: Sorted multi-select options alphabetically to adhere to n8n node linting standards.