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.