n8n Integration
Connect the full power of Databar to n8n.
Connect Databar to your n8n workflows to enrich data, run waterfalls, and manage tables.
Getting Started
Prerequisites
Before you begin, make sure you have:
An n8n instance (Cloud or self-hosted, version 1.0+)
A Databar API key (found in your workspace under Integrations)
Installation
n8n Cloud
In your n8n instance, go to Settings > Community Nodes
Click Install
Enter n8n-nodes-databar
Confirm the installation
The Databar node will appear in your node panel. If the node doesn't appear, you may need to restart your n8n instance.
Alternatively, install via npm:
npm install n8n-nodes-databarThen restart n8n.
Setting Up Credentials
Open any workflow and add a Databar node
Click the Credential dropdown and select Create New
Enter your Databar API key
Click Save - the connection gets tested automatically. When successfully tested, n8n should display that you have been successfully authorized.
The API key gives access to all resources in that workspace. If you have multiple workspaces, create separate credentials for each.
Your API key is found in your Databar workspace under Integrations. Each workspace has its own API key. Please ensure you have the necessary access levels for the n8n integration to work properly.
Resources and Operations
The Databar node organizes functionality into four resources:
Enrichment
Run
Enrich a single record using any Databar enrichment
Table
Insert Rows, Upsert Rows
Add or update rows in your Databar tables
Waterfall
Run
Run a waterfall across multiple data providers
Other
Get Account Info
Check your account balance and plan details
Enrichment: Run
Use this to enrich a single record - look up a person by email, verify a phone number, get company data from a domain, and more. There are over 450 enrichments currently available.
How to configure
Set Resource to Enrichment
Set Operation to Run
Select an Enrichment from the dropdown - browse all available enrichments with descriptions and credit costs
Fill in the Parameters - the form is generated dynamically based on the enrichment you selected. Required fields are marked.
Choose whether to Wait for Completion (enabled by default). This mode is highly preferred to avoid complexity in the integration.
Parameters
Enrichment
The enrichment to run. The dropdown is searchable - type to filter. Each option shows the name, data source, and credit cost.
Parameters
Input fields specific to the selected enrichment. These are generated dynamically - for example, an email verifier will show an "Email" field, while a company lookup will show a "Domain" field.
Wait for Completion
When enabled (default), the node waits for the enrichment to finish and returns the results directly. When disabled, it returns a task_id immediately that you can check later.
Additional Options (when Wait for Completion is enabled)
Poll Interval
3 seconds
How often to check if the enrichment has completed
Timeout
300 seconds
Maximum time to wait before the node gives up
Example: Enrich a contact by email
Add a Databar node to your workflow
Resource: Enrichment, Operation: Run
Select "Get people data from email" from the enrichment dropdown
Enter the email address in the Email field (or map it from a previous node)
Execute the node
The output will contain the enriched contact data - name, company, social profiles, and more, depending on the enrichment.
Tips
You can map values from previous nodes into any parameter field using n8n expressions
Each enrichment costs a certain number of credits, shown in the dropdown
If you need to enrich many records, connect a loop or use n8n's built-in batching - the node processes one item per execution
Table: Insert Rows
Use this to add new rows to a Databar table. Each input item in your workflow creates one row.
How to configure
Set Resource to Table
Set Operation to Insert Rows
Select a Table from the dropdown
Fill in the Fields - the form shows all columns in your table with their types (e.g., name (text), revenue (number))
Parameters
Table
Select the target table. The dropdown is searchable and shows all tables in your workspace.
Fields
One input field per column in the table. Each field label shows the column name and type. Only user-created columns are shown - enrichment-generated columns are filtered out.
Options
Click Add Option to configure additional behavior:
Allow New Columns
false
When enabled, if your data includes column names that don't exist in the table yet, Databar will create them automatically as text columns.
Dedupe
false
When enabled, rows that match existing rows on specified keys will be skipped instead of creating duplicates.
Dedupe Keys
-
Comma-separated list of column names to use for duplicate detection (e.g., domain, email). Only shown when Dedupe is enabled.
Example: Insert leads from a webhook
Set up a Webhook node to receive lead data
Add a Databar node: Resource Table, Operation Insert Rows
Select your leads table
Map the webhook fields to table columns (e.g., {{ $json.name }} into the Name field)
Execute - each incoming webhook creates a new row
Table: Upsert Rows
Use this to update an existing row if it matches a key, or insert a new row if no match is found. This is useful for keeping your table in sync with external data.
How to configure
Set Resource to Table
Set Operation to Upsert Rows
Select a Table from the dropdown
Choose a Column to Match On - this is the column Databar will use to find existing rows
Enter the Value to Search - the specific value to look for in that column
Fill in the Fields - the column values to set on the matched or newly created row
Parameters
Table
The target table.
Column to Match On
The column used to find an existing row. The dropdown shows all user-created columns in the table.
Value to Search
The value to look for in the match column. Databar searches for a row where the column matches this value exactly. If found, that row is updated. If not found, a new row is created.
Fields
The column values to set. Works the same as Insert Rows - one field per column, with types shown.
Example: Sync CRM data
Use a Schedule Trigger to run daily
Fetch contacts from your CRM
Add a Databar node: Resource Table, Operation Upsert Rows
Select your contacts table
Set Column to Match On to email
Map the email from the CRM data into Value to Search
Map the other CRM fields into the column fields
Execute - existing contacts are updated, new ones are inserted
Waterfall: Run
A waterfall tries multiple data providers in sequence until one returns a successful result. This is useful when you need high coverage - if one provider doesn't have the data, the next one is tried automatically.
How to configure
Set Resource to Waterfall
Set Operation to Run
Select a Waterfall from the dropdown
Fill in the Parameters - the form is generated dynamically based on the waterfall's input requirements
Select Data Providers - choose which providers to include in the waterfall (required)
Choose whether to Wait for Completion (enabled by default)
Parameters
Waterfall
The waterfall to run. The dropdown shows all waterfalls in your workspace.
Parameters
Input fields specific to the selected waterfall. For example, a "Find email by name and company" waterfall might show fields for First Name, Last Name, and Domain.
Data Providers
Multi-select dropdown showing all available providers for this waterfall. You must select at least one. Providers are tried in order - the waterfall stops at the first successful result. Each provider shows its name and credit cost.
Wait for Completion
When enabled (default), the node waits for the waterfall to finish. When disabled, returns a task_id immediately.
Additional Options (when Wait for Completion is enabled)
Poll Interval
3 seconds
How often to check if the waterfall has completed
Timeout
300 seconds
Maximum time to wait
Example: Find someone's email
Add a Databar node
Resource: Waterfall, Operation: Run
Select a "Find email" waterfall
Fill in the person's name and company domain
Select the data providers you want to try
Execute - returns the email from the first provider that finds it
Other: Get Account Info
A simple utility operation to check your account status.
How to configure
Set Resource to Other
Set Operation to Get Account Info
Execute
Output
Returns your account details including:
Account name and email
Current credit balance
Plan information
Workspace details
This is useful for monitoring your credit usage in automated workflows.
Working with Expressions
All fields in the Databar node support n8n expressions. This lets you dynamically pass data from previous nodes.
Mapping data from a previous node
In any field, click the Expression toggle and use standard n8n syntax:
{{ $json.email }}- value from the previous node's output{{ $('Webhook').item.json.domain }}- value from a specific node named "Webhook"{{ $json.name.split(' ')[0] }}- JavaScript expressions for transformations
Using dynamic table or enrichment IDs
If you need to select a table or enrichment dynamically (e.g., based on input data), switch the dropdown to Expression mode by clicking the three-dot menu next to the field, then enter an expression that resolves to the ID.
Error Handling
Common errors and solutions
Authentication failed
Invalid or expired API key
Check your API key in credentials. Generate a new one in Databar under Integrations if needed.
Task timed out
Enrichment or waterfall took longer than the timeout
Increase the timeout in Additional Options, or disable Wait for Completion and poll separately.
No enrichments loading
API connectivity issue
Check your internet connection and verify your API key has the correct permissions.
Fields not appearing
No table selected
Select a table first, column fields load dynamically after table selection.
Using the error output
You can connect the Databar node's error output (the red dot) to a separate branch to handle failures gracefully - for example, logging errors or retrying with different parameters.
Workflow Examples
Lead enrichment pipeline
Enrich incoming leads with company data, filter by criteria, and notify your team.
Data sync with deduplication
Periodically sync data from a spreadsheet into a Databar table, skipping duplicates.
Multi-provider email finder
Find emails using a waterfall of providers, then store results in a table - updating existing rows if the person is already in your table.
Credit monitoring
Check your credit balance daily and get notified when it's running low.
FAQ
How many credits does each operation cost?
Credit costs depend on the specific enrichment or data provider. Costs are shown in the enrichment and provider dropdowns when configuring the node.
Can I process multiple records in one execution?
Yes. Connect a node that outputs multiple items (like a spreadsheet read or database query) before the Databar node. The node processes each item individually.
What happens if an enrichment returns no data?
The node will return the task response with empty or null result fields. Your workflow can check for this and handle it accordingly.
Last updated
Was this helpful?