n8n Integration
Connect Keboola with n8n to automate workflows, trigger data pipelines, and integrate Keboola’s data platform with hundreds of other services.
n8n is an open-source workflow automation tool. With the Keboola integration for n8n, you can orchestrate data pipelines, move data between systems, and embed Keboola into your broader automation ecosystem.
In this guide, you’ll learn how to set up the Keboola node in n8n, connect it to your project, and start building workflows.
Prerequisites
Section titled “Prerequisites”Before you begin, make sure you have:
- A Keboola project (You can create one for free).
- A Keboola Storage API Token (with the necessary permissions).
- An n8n instance (currently, just the self-hosted variant is supported).
Install the Keboola Node (Self-hosted)
Section titled “Install the Keboola Node (Self-hosted)”If you’re running a self-hosted n8n instance, you can install the Keboola node via the Community Nodes feature.
- 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.
You can now use the Keboola node in your workflows.
Authentication
Section titled “Authentication”The Keboola node uses API Key authentication.
- In the n8n Editor UI, click the Add button (+) in the sidebar and select Create Credential.
- Search for Keboola Token API and click Continue.
- Select your stack region from the dropdown:
- 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)
- Enter your Keboola Storage API Token associated with the selected region.
- You can find or create tokens in Keboola under Project Settings → API Tokens.
- Click Save. You should see a confirmation message once the connection is established.
Once configured, the credential can be reused across all Keboola nodes in your workflows.
Create a Workflow with the Keboola Node
Section titled “Create a Workflow with the Keboola Node”Once your credential is configured, you can start building workflows with the Keboola node.
- In n8n, create a new workflow.
- In the Editor UI, click the Open nodes panel button (+) on the canvas.
- Search for a Keboola node.
- Select the Action you want to perform:
- Data Export – extract data from a Keboola table.
- Data Import – write data from your workflow into a Keboola table.
- Configure the node parameters (e.g., table ID for download, bucket and table details for upload).
- Connect the Keboola node with other n8n nodes (e.g., Google Sheets, MCP, Slack, HTTP Request) to design your automation.
- Execute the workflow to test and validate your integration.
Available Operations
Section titled “Available Operations”The Keboola node currently supports two main operations:
Data Export
Section titled “Data Export”Extracts data from a Keboola table.
- Parameters:
- Credential (select your Keboola connection)
- Resource (Table)
- Operation (Extract)
- Table ID
This lets you pull data from a specific table and pass it to downstream nodes in your workflow.
Data Import
Section titled “Data Import”Uploads data from your workflow into Keboola.
- Parameters:
- Credential (select your Keboola connection)
- Resource (Table)
- Operation (Upload)
- Bucket Stage (Input/Output)
- Bucket Name
- Table Name
- Primary Key(s)
- Import Mode (Full Load or Incremental)
This allows you to insert or update tables inside Keboola directly from your n8n workflows.
Custom API Call
Section titled “Custom API Call”If you need functionality that isn’t covered by the node’s built-in actions, you can use the Custom Keboola API Call option to send requests directly to the Storage API. This gives you full flexibility until additional actions are added to the node.
Resources
Section titled “Resources”Troubleshooting
Section titled “Troubleshooting”- Authentication errors: Verify that your API Token has sufficient permissions for the chosen operation.
- Operation errors: Double-check input parameters such as bucket names, table IDs, or job IDs.
- Node not available: Confirm the Keboola node is installed from the Community Nodes registry. There is currently support for self-hosted n8n instances only. We are working on adding support for n8n Cloud too (stay tuned).
For further help, reach out via Keboola Support.