Description
n8n-nodes-influx
An n8n community node for InfluxDB — the time series database platform for metrics, events, and real-time analytics. This node supports InfluxDB 1.x, 2.x, and 3.x with version-specific operations, query languages, and authentication.
n8n is a fair-code licensed workflow automation platform.
Installation | Operations | Credentials | Compatibility | Resources
Features
- Three InfluxDB versions — unified node supporting v1, v2, and v3 with version-specific resources and operations
- Multiple query languages — InfluxQL (v1/v2/v3), Flux (v2), and SQL (v3)
- Parameterized queries — pass named parameters to SQL and InfluxQL queries (v3)
- Response format options — choose between JSON, JSONL, or CSV output for v3 queries
- Structured and raw writes — write data points with field mappings or paste raw line protocol
- Write tuning — configurable timestamp precision, partial write acceptance, and WAL sync bypass (v3)
- Full resource management — databases, buckets, retention policies, tables, caches, tokens, and organizations
- Organization lookup by ID or name — skip the extra API call when you already have the org ID (v2)
- Pagination — automatic pagination with return-all toggle for bucket and organization listings (v2)
- Deletion safety — confirmation toggle on all destructive operations to prevent accidental deletion
- Credential defaults — set a default database, organization, or bucket in credentials to auto-fill node fields
- Query profiling — enable Flux query profiling with named profilers (v2)
- Epoch precision — control timestamp format in InfluxQL query responses (v1)
- AI agent integration —
usableAsToolenabled for use in n8n AI workflows - Continue on fail — standard n8n error handling support
- Minimum n8n version: 1.71.0 (
n8nNodesApiVersion1) - InfluxDB 1.x: tested with 1.8
- InfluxDB 2.x: tested with 2.7
- InfluxDB 3.x: tested with InfluxDB 3 Core (latest)
- Node.js 22+
- just command runner
- Docker (for e2e tests and manual testing)
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
InfluxDB 1.x
| Resource | Operations |
|———-|———–|
| Query | Execute InfluxQL Query |
| Write | Write Points, Write Raw Line Protocol |
| Database | Create, Delete, Get Many |
| Retention Policy | Create, Delete, Get Many, Update |
| Server | Ping |
InfluxDB 2.x
| Resource | Operations |
|———-|———–|
| Query | Execute Flux Query, Execute InfluxQL |
| Write | Write Points, Write Raw Line Protocol |
| Bucket | Create, Delete, Get, Get Many, Update |
| Organization | Get, Get Many |
| Server | Health Check, Ping, Ready |
InfluxDB 3.x
| Resource | Operations |
|———-|———–|
| Query | Execute SQL, Execute InfluxQL |
| Write | Write Points, Write Raw Line Protocol |
| Database | Create, Delete, Get Many, Update |
| Table | Create, Delete |
| Cache | Create/Delete Last Value Cache, Create/Delete Distinct Value Cache |
| Token | Create Admin, Create Named Admin, Delete, Regenerate Admin |
| Server | Health Check, Ping, Metrics |
Credentials
Three credential types are available, one for each InfluxDB version. Select the API version in the node to see the matching credential type.
InfluxDB 1.x API
| Field | Required | Description |
|——-|———-|————-|
| Host URL | Yes | Base URL of your InfluxDB instance (e.g. http://127.0.0.1:8086) |
| Username | No | Username for Basic authentication |
| Password | No | Password for Basic authentication |
| Default Database | No | Pre-fills database fields in the node |
| Ignore SSL Issues | No | Skip TLS certificate validation |
InfluxDB 2.x API
| Field | Required | Description |
|——-|———-|————-|
| Host URL | Yes | Base URL of your InfluxDB instance (e.g. http://127.0.0.1:8086) |
| API Token | Yes | Token for authentication (Token header) |
| Default Organization | No | Pre-fills organization fields in the node |
| Default Bucket | No | Pre-fills bucket fields in the node |
| Ignore SSL Issues | No | Skip TLS certificate validation |
InfluxDB 3.x API
| Field | Required | Description |
|——-|———-|————-|
| Host URL | Yes | Base URL of your InfluxDB instance (e.g. http://127.0.0.1:8181) |
| API Token | Yes | Token for authentication (Bearer header) |
| Default Database | No | Pre-fills database fields in the node |
| Ignore SSL Issues | No | Skip TLS certificate validation |
All credential types include a connectivity test that runs automatically when you save.
Compatibility
Development
Prerequisites
Commands
| Recipe | Description |
|——–|————-|
| just build | Compile TypeScript to dist/ |
| just dev | Watch mode — starts local n8n with the node loaded |
| just lint | Run the n8n node linter |
| just lint-fix | Lint and auto-fix |
| just format | Run Prettier |
| just format-check | Check formatting without writing |
| just test | Run unit + integration tests |
| just test-unit | Run unit tests only |
| just test-int | Run integration tests only |
| just test-e2e | Run e2e tests (requires Docker) |
| just test-all | Run all test suites |
| just test-coverage | Unit + integration with coverage enforcement |
| just check | Full pre-publish check: lint + format + tests + build + verify |
| just verify | Run the n8n community package scanner |
Manual Testing with Docker
Docker Compose provides containers for all three InfluxDB versions with sample data:
just docker-start # start all containers + seed sample data
just dev # start n8n at localhost:5678
test in browser...
just docker-down # stop containers
Start a single version:
just docker-start v1 # only InfluxDB 1.x
just docker-start v2 # only InfluxDB 2.x
just docker-start v3 # only InfluxDB 3.x
Run just docker-info to print credential values for n8n.
See docs/manual-testing.md for a full testing checklist covering all 46 operations.
Test Suites
test/unit/) — transport layer, action handlers, parsers, credentialstest/integration/) — full node execution with mock HTTP servertest/e2e/) — real InfluxDB containers via testcontainersDesign & Planning
See DESIGN.md for architecture docs, epics, and stories.
Resources
Version History
See CHANGELOG.md.
