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).

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).

---

📝 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)
Organization	Enrich	organizationDomain (required), organizationId (opt)
Organization	Bulk Enrich	organizationDomainsJson (JSON array, 1-10 domains)

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!