n8n Connector - Entity Enricher Documentation

n8n Connector

The Entity Enricher community node for n8n lets you build automated enrichment pipelines with a visual drag-and-drop editor. Connect to 400+ apps without writing code.

Installation

Install the community node in your n8n instance:

npm install n8n-nodes-entity-enricher

Or install via the n8n UI: go to Settings → Community Nodes and search for n8n-nodes-entity-enricher.

Prerequisites

API Key— Create an organization access key in Entity Enricher. See the API Keys documentation for details. The key format is ent_XXXXXXXXXXXX.

Base URL— The URL of your Entity Enricher instance (e.g., https://entityenricher.ai or your self-hosted URL).

Credential Setup— In n8n, create an Entity Enricher API credential with your API key and base URL. All nodes will use this credential.

Available Operations

The connector exposes 8 operations across 5 resource categories:

Resource	Operation	Description
Enrichment	Enrich Entity	Enrich a single entity with one or more AI models. Streams results via SSE with real-time progress.
Enrichment	Batch Enrich	Enrich all input items as a single batch. Parallel processing with per-entity progress tracking.
Schema	List Schemas	List available saved schemas for selection in enrichment workflows.
Schema	Get Schema Details	Retrieve full schema content with extracted key properties for a specific schema.
Record	List Records	Query enrichment records with type and success filters. Paginated results.
Record	Get Record	Retrieve a specific enrichment result by ID with full structured output.
Fusion	Merge Results	Fuse results from multiple enrichment records with optional LLM arbitration.
Configuration	Get Options	Fetch available models, languages, strategies, and plan limits for dynamic configuration.

Single Entity Enrichment

The simplest workflow: trigger on new data, enrich a single entity, and push the result to your destination. The node waits for the full enrichment to complete before passing the structured output downstream.

Example workflow — single entity enrichment:

n8n workflow for single entity enrichment

Node configuration — Enrich Entity operation:

Configuration

Select a schema from the dynamic dropdown, choose one or more models, and provide entity data as key-value fields. The node auto-populates search key fields based on the selected schema.

Optional settings include strategy (single-pass or multi-expertise), languages for multilingual output, classification model for entity type verification, and arbitration model for multi-model conflict resolution.

Batch Enrichment

Process all input items as a single batch. Ideal for enriching lists from spreadsheets, databases, or API responses. All entities are processed in parallel with per-provider rate limiting.

Example workflow — batch enrichment:

n8n workflow for batch entity enrichment

Node configuration — Batch Enrich operation:

Entity Enricher node configuration for batch enrichment

How Batch Mode Works

Collect items — The node gathers all input items from the previous node (e.g., rows from a spreadsheet).
Start batch job — All entities are submitted via POST /api/batch/start and processed in parallel.
Stream progress — The node consumes the SSE stream until all entities complete or the timeout is reached.
Output results — One output item per entity with the enriched structured data, ready for downstream processing.

Key Features

Dynamic Dropdowns

Schema, model, language, and strategy selectors fetch options from your Entity Enricher instance at configuration time.

SSE Streaming

Enrichment operations consume the SSE stream in real-time, waiting for completion before returning results to the next node.

Auto-Continue

When pre-flight classification detects a mismatch, the connector automatically continues (n8n workflows are non-interactive).

Configurable Timeout

Default 300-second timeout per enrichment call, adjustable per node for large schemas or slow models.

Multi-Model Support

Select multiple models per enrichment. When 2+ models are used, results are automatically fused.

Clean Output by Default

By default, the output contains only the enriched data fields. Toggle "Include Enrichment Metadata" to add cost, tokens, fusion details, and record IDs.

Per-Model Output

Optionally output individual model results alongside the fused result for downstream comparison.

Plan Limit Awareness

Model and language dropdowns display plan limits when configured. HTTP 402 errors from quota enforcement are surfaced as clear, actionable messages with limit details. Metadata output includes current plan limits for downstream routing.

Workflow Ideas

Common patterns for building enrichment pipelines with n8n:

CRM Enrichment— Trigger on new HubSpot/Salesforce contacts, enrich with company data, update the CRM record.

Spreadsheet Pipeline— Read entities from Google Sheets, batch enrich, write results back to a new sheet.

Waterfall Enrichment— Chain multiple enrichment steps with conditional logic — use a fast model first, re-enrich failures with a more capable model.

Scheduled Refresh— Run on a cron schedule to re-enrich stale records with the latest AI models.

Webhook-Driven— Expose a webhook endpoint that accepts entity data, enriches it, and returns the result synchronously.