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 — usableAsTool enabled for use in n8n AI workflows
• Continue on fail — standard n8n error handling support

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 <value> 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 <value> 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

• Minimum n8n version: 1.71.0 (n8nNodesApiVersion 1)
• InfluxDB 1.x: tested with 1.8
• InfluxDB 2.x: tested with 2.7
• InfluxDB 3.x: tested with InfluxDB 3 Core (latest)

Development

Prerequisites

• Node.js 22+
• just command runner
• Docker (for e2e tests and manual testing)

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

• Unit tests (test/unit/) — transport layer, action handlers, parsers, credentials
• Integration tests (test/integration/) — full node execution with mock HTTP server
• E2E tests (test/e2e/) — real InfluxDB containers via testcontainers

Design & Planning

See DESIGN.md for architecture docs, epics, and stories.

Resources

• n8n community nodes documentation
• InfluxDB 1.x documentation
• InfluxDB 2.x documentation
• InfluxDB 3 documentation

Version History

See CHANGELOG.md.