n8n

The @qrdx/n8n-nodes-qrdx package adds two nodes to n8n:

• QRdx makes QR code images, creates and edits dynamic codes, and reads their scans and your saved themes. An n8n AI Agent can use it as a tool.
• QRdx Trigger starts a workflow when your codes are scanned, created or changed, or when someone submits a form on a hosted page.

The package is on npm as @qrdx/n8n-nodes-qrdx and installs into a self-hosted n8n. n8n Cloud only runs community nodes that n8n has verified, and this one isn't verified yet.

To receive events without installing anything, use a Webhook node instead.

InstallCopy Anchor Link

In n8n, open Settings → Community Nodes, click Install, enter @qrdx/n8n-nodes-qrdx, accept the note about community nodes and click Install. Then search for QRdx in the nodes panel.

If your n8n hides that page, or you manage it from the command line, install the package in the nodes folder of your n8n user folder and restart n8n:

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install @qrdx/n8n-nodes-qrdx

If n8n runs in Docker, run the same commands inside the container (docker exec -it n8n sh) or set them up in your image.

Connect your workspaceCopy Anchor Link

Create an API key in Settings → API keys & apps, then add a QRdx API credential in n8n with the key. Leave Base URL as https://api.qrdx.dev/v1 unless you self-host QRdx; then use your address followed by /api/v1.

n8n tests the credential by reading your profile, which needs the Profile scope, so a key with full access is simplest. A key acts on the workspace it was created in. Generating QR images needs no credential at all.

The QRdx nodeCopy Anchor Link

Generate puts the image in a binary field you can attach to an email or upload anywhere. You can set its size, colors, body, eye and eye dot shapes, error correction, margin, a frame with its label, and a logo icon. The output also has url: a link to the same image from the image API, ready for an <img> tag.

The code and scan operations call the REST API with your key and count toward the workspace's daily API quota. Get Many pages through results for you. Errors keep QRdx's own message; a custom back-half needs Pro or Business, for example, and the node shows the error QRdx returns on Free.

The QRdx Trigger nodeCopy Anchor Link

Pick the events, then activate the workflow. The node subscribes through the REST Hooks API and unsubscribes when you deactivate the workflow. The subscription shows in Settings → Webhooks while it's active.

The node checks each delivery's X-QRdx-Signature with the signing secret QRdx returned when it subscribed, and answers 401 to anything that doesn't match. Turn on Output One Item per Scan to get a Scans batch as separate items, and Include Test Events to run the workflow when you click Send test in Settings → Webhooks. The payloads are the ones described in Webhooks.

The trigger needs:

• the Business plan, since webhooks are part of it
• an API key with the Manage codes scope
• n8n at a public https:// address, because QRdx doesn't deliver to localhost or private networks. Behind a proxy, set n8n's WEBHOOK_URL. This also applies to the test URL n8n uses while you click Listen for test event

Without the packageCopy Anchor Link

QRdx can deliver events to an n8n Webhook node directly, on n8n Cloud or a self-hosted n8n:

1. Add a Webhook node, set its HTTP method to POST and copy its production URL.
2. Activate the workflow. The production URL only answers while the workflow is active.
3. In Settings → Webhooks, click Add endpoint, paste the URL and pick the events.

Each event starts the workflow with the JSON payload. To check signatures, read X-QRdx-Signature in a Code node and verify it with the endpoint's signing secret.