@keboola/n8n-nodes-keboola

n8n Nodes – Keboola Integration

This is an n8n community node that integrates Keboola with your n8n workflows, so you can automate data pipelines, upload and download tables, and connect Keboola to hundreds of other services through n8n.

Keboola is a data platform for building and running data pipelines, while n8n is a fair-code licensed workflow automation tool. Together, they allow you to orchestrate data flows end-to-end with minimal effort.

Table of Contents

• Installation (self-hosted)
• Installation for development and contributing
• Operations
• Credentials
• Compatibility
• Usage
• Resources
• Release
• Version History
• Troubleshooting

Installation (self-hosted)

To install the Keboola community node directly from the n8n Editor UI:

• Open your n8n instance.
• Go to Settings → Community Nodes.
• Select Install a community node.
• Enter the npm package name: @keboola/n8n-nodes-keboola
• Accept the community node disclaimer and confirm installation.

The Keboola node is now available in your workflows.

Installation for development and contributing

If you want to contribute to this project, you can link the node to your local n8n instance.

Prerequisites

• Node.js (recommended v20+)

Steps

• Initialize n8n locally

Install and start n8n (if not already installed):

npm install -g n8n
n8n start

This will create the ~/.n8n directory.

• Clone and build the node

git clone [e-mail]:keboola/n8n-nodes-keboola.git # or https://github.com/keboola/n8n-nodes-keboola.git
cd n8n-nodes-keboola
npm install
npm run build

• Link the custom node to n8n

mkdir -p ~/.n8n/custom
ln -s /full/path/to/n8n-nodes-keboola ~/.n8n/custom/n8n-nodes-keboola

• Restart n8n

n8n start

• Making changes

If you modify the node, rebuild and restart:

pnpm run build
n8n start

Operations

The Keboola node currently supports three types of operations:

• Data Export

Extracts data from a Keboola table into your n8n workflow. - Parameters: Credential, Table ID

• Data Import

Uploads data from your workflow into a Keboola table. - Parameters: Bucket Stage, Bucket Name, Table Name, Primary Key(s), Import Mode

• Custom API Call

For advanced use cases, you can call any Keboola Storage API endpoint directly.

Credentials

The node uses API Key authentication.

When creating a credential in n8n, select your Keboola stack region:

• https://connection.keboola.com (Stack: AWS, Region: us-east-1)
• https://connection.eu-central-1.keboola.com (Stack: AWS, Region: eu-central-1)
• https://connection.north-europe.azure.keboola.com (Stack: Azure, Region: north-europe)
• https://connection.us-east4.gcp.keboola.com (Stack: US East, Region: us-east4)

Then provide your Keboola Storage API Token (create under Project Settings → API Tokens in Keboola).

Compatibility

This node has been tested with n8n version 1.57.0 and newer.

Usage

• Create a new workflow in n8n.
• Add the Keboola node.
• Select an operation:
  • Data Export to pull a table.
  • Data Import to write into Keboola.
  • Custom API Call for advanced use.
• Configure the parameters.
• Connect with other nodes (e.g., Google Sheets, Slack, HTTP).
• Execute the workflow.

Resources

• Keboola API Documentation
• n8n Documentation
• n8n Community Nodes Guide
• n8n Keboola Documentation
• NPM Package
• GitHub Repository

Release

This project uses GitHub Actions to publish releases to npm. To create a release:

• Ensure main is up to date.
• Bump the version in package.json according to semver.
• Commit and push.
• Create a GitHub Release with the new version tag (e.g., v1.0.0).

The CI workflow will build, test, and publish automatically.

Version History

See Releases.

Troubleshooting

• Authentication errors: Verify your API token and stack region are correct.
• Operation errors: Double-check bucket names, table IDs, or job IDs.
• Node not available: Confirm the Keboola node is installed from the Community Nodes registry. Currently only self-hosted n8n is supported.

For additional help, open an issue in this repo or contact Keboola Support.