Connecting your n8n instance
Connecting your n8n instance
Section titled “Connecting your n8n instance”Each tenant can connect its own n8n instance to the Nekazari platform. Once connected, the platform can query workflows, executions, and trigger automations through n8n’s API.
Prerequisites
Section titled “Prerequisites”- A running n8n instance (self-hosted or cloud) accessible via HTTPS
- TenantAdmin or PlatformAdmin role in Nekazari
Step 1: Get your n8n API key
Section titled “Step 1: Get your n8n API key”- Log into your n8n instance
- Go to Settings → API
- Click Create API Key
- Copy the generated key — you won’t be able to see it again
Step 2: Configure in Nekazari
Section titled “Step 2: Configure in Nekazari”- Go to the n8n module page at
/n8n-hub - Expand n8n Configuration (admin only)
- Enter your n8n URL (e.g.,
https://n8n.my-company.com) - Paste your API key
- Click Test connection — you should see “Connection OK”
- Click Save
Step 3: Verify
Section titled “Step 3: Verify”After saving, the module will use your n8n instance for all API calls. You should see workflow status and execution data from your instance.
The Open n8n button will link directly to your configured URL.
Troubleshooting
Section titled “Troubleshooting”| Issue | Solution |
|---|---|
| Connection timed out | Check your n8n instance is running and accessible from the internet |
| HTTP 401 | Your API key may be invalid — generate a new one |
| HTTP 403 | Check the API key has sufficient permissions |
| Private IP rejected | Only https:// URLs are accepted. Localhost/private IPs are not allowed in production |
Provisioning a hosted instance
Section titled “Provisioning a hosted instance”If you don’t have your own n8n instance, you can activate a hosted one from the module page (Enterprise included, or 4.99€/month as an addon). The platform will provision and manage an isolated n8n instance for your tenant.
See the n8n auto-provisioning documentation for details.