n8n-nodes-apollo

Community n8n node for the Apollo API. Supports Person, Organization, Contact, Account, Deal, Sequence, Task, Call, List, Email Account, User, Custom Field, Stage, and Analytics operations.

• Package: n8n-nodes-apollo
• Requires: Node.js >= 20
• License: MIT
• Repository: https://github.com/arturl95/n8n-nodes-apollo
• npm: https://www.npmjs.com/package/n8n-nodes-apollo
• Maintainer: AlusLabs — automation systems and SaaS development

Installation (in n8n)

1. In n8n, go to Settings → Community Nodes → Install.
2. Enter the package name: n8n-nodes-apollo and install.
3. Create credentials for "Apollo API" with your API key and optional base URL.

Credentials

Credential: Apollo API (credentials/ApolloApi.credentials.ts)

• API Key: Injected via x-api-key header.
• Base URL: Defaults to https://api.apollo.io.
• Test: GET /api/v1/auth/health against the Base URL.

Many of the team-CRM and engagement endpoints (Account update, Deal, Task, Call, Sequence, User, Email Account, Custom Field, Stage, Analytics) require a master API key. Operations that need one are labelled "(Master API key)" in the UI. Regular keys will get 403 on those endpoints.

Supported resources and operations

Resource: Person

• Enrich Person — POST /api/v1/people/match
• Search People — POST /api/v1/mixed_people/search
• Bulk Enrich People — POST /api/v1/people/bulk_match

Resource: Organization

• Enrich Organization — GET /api/v1/organizations/enrich
• Bulk Enrich Organizations — POST /api/v1/organizations/bulk_enrich
• Search Organizations — POST /api/v1/mixed_companies/search
• Get Job Postings — GET /api/v1/organizations/{organization_id}/job_postings

Resource: Contact

• Create Contact — POST /api/v1/contacts
• Update Contact — PATCH /api/v1/contacts/{contact_id}
• Search Contacts — POST /api/v1/contacts/search

Resource: Account

• Create Account — POST /api/v1/accounts (master key)
• Search Accounts — POST /api/v1/accounts/search
• Update Account — PATCH /api/v1/accounts/{account_id} (master key)

Resource: Deal

• Create Deal — POST /api/v1/opportunities
• List All Deals — GET /api/v1/opportunities/search
• View Deal — GET /api/v1/opportunities/{opportunity_id}
• Update Deal — PATCH /api/v1/opportunities/{opportunity_id}

Resource: Sequence (master key)

• Search Sequences — POST /api/v1/emailer_campaigns/search
• Add Contacts — POST /api/v1/emailer_campaigns/{id}/add_contact_ids
• Remove or Stop Contacts — POST /api/v1/emailer_campaigns/remove_or_stop_contact_ids
• Activate Sequence — POST /api/v1/emailer_campaigns/{id}/approve
• Deactivate Sequence — POST /api/v1/emailer_campaigns/{id}/abort
• Archive Sequence — POST /api/v1/emailer_campaigns/{id}/archive

Resource: Task (master key)

• Create Task — POST /api/v1/tasks
• Bulk Create Tasks — POST /api/v1/tasks/bulk_create
• Search Tasks — POST /api/v1/tasks/search

Resource: Call (master key)

• Create Call — POST /api/v1/phone_calls
• Search Calls — GET /api/v1/phone_calls/search
• Update Call — PUT /api/v1/phone_calls/{id}

Resource: List

• Get Lists — GET /api/v1/lists
• Create List — POST /api/v1/lists
• Update List — PATCH /api/v1/lists/{id}
• Add Contacts — POST /api/v1/lists/{id}/add_contacts

Resource: Email Account (master key)

• Get Email Accounts — GET /api/v1/email_accounts

Resource: User (master key)

• Get Users — GET /api/v1/users

Resource: Custom Field (master key)

• Get Custom Fields — GET /api/v1/fields
• Create Custom Field — POST /api/v1/fields

Resource: Stage (master key)

• Get Contact Stages — GET /api/v1/contact_stages
• Get Account Stages — GET /api/v1/account_stages
• Get Opportunity Stages — GET /api/v1/opportunity_stages

Resource: Analytics (master key)

• Get API Usage — POST /api/v1/usage_stats/api_usage_stats
• Get Sync Report — POST /api/v1/sync/report

Usage notes

• People Search does not generate new emails or phone numbers; use People Enrichment to retrieve contact details.
• Most filters are exposed as query parameters and support multiple values via n8n "Fixed Collection" fields (e.g., person_titles[], organization_locations[]).
• Pagination parameters page and per_page are available where supported.
• Contact Create/Update body is constructed from simple fields and Fixed Collections (e.g., label_names). Pass typed_custom_fields as a JSON object string (e.g., { "60c39...": "2025-08-07" }). Use Apollo's Custom Fields API to discover field IDs and valid data types.
• Apollo does not deduplicate on Create Contact. If you create a contact that already exists, Apollo will create a separate new contact.
• Some workspace-only endpoints have limits or plan requirements:
  • Contacts/Accounts Search results are capped (100 per page, up to 500 pages). Narrow filters to stay within limits.
  • Deals endpoints require a master API key; otherwise you will receive 403 responses.

Use cases

This node is used in production for lead enrichment and outbound automation workflows, including:

• Lead enrichment pipelines for sales teams
• ICP-based prospecting and segmentation
• CRM data enrichment and sync

For an example of Apollo integration in a full outbound system, see Parlantex — an AI-powered outbound platform that uses this node for prospect enrichment.

Development

npm run lint
npm run build
npm run dev

Artifacts are emitted to dist/. Icons from nodes/** and credentials/** are copied to dist by the Gulp task build:icons.

Changelog

• 0.2.0

  • Added resources: Sequence, Task, Call, List, Email Account, User, Custom Field, Stage, Analytics
  • Fixed credential test endpoint path (/api/v1/auth/health)
  • Fixed Organization Enrich method (POST) and Contact Update method (PATCH)
  • Labelled master-key-only operations in the UI
  • Removed query-parameter auth fallback (Apollo deprecated September 2024)

• 0.1.1

  • Added Contact: Search Contacts; Create/Update field coverage and typed_custom_fields support
  • Added Account: Search Accounts with filtering, sorting, and pagination
  • Added Deal resource (UI label) with Create/List/View/Update endpoints
  • Alphabetized resource list and fixed lint issues; improved README usage notes

• 0.1.0

  • Initial release: Apollo credentials and node
  • Person: Enrich, Search, Bulk Enrich
  • Organization: Enrich, Bulk Enrich, Search, Job Postings

About

This node is maintained by AlusLabs, a consulting studio that builds automation systems, AI tools, and SaaS products. For custom n8n development or automation consulting, get in touch.

License

MIT