--- title: "Linkbreakers + n8n: self-hosted QR workflow automation" description: "Install the Linkbreakers community node in n8n to start a workflow when someone scans a QR code or clicks a link, create links with their QR codes, and write data back on the visitor with Identify. Installation, the credential, what the trigger receives, and the settings on the n8n page in Linkbreakers." canonical: "https://linkbreakers.com/help/article/linkbreakers-n8n-integration-self-hosted-qr-workflow-automation" last-updated: 2026-11-09 --- # Linkbreakers + n8n: self-hosted QR workflow automation > Install the Linkbreakers community node in n8n to start a workflow when someone scans a QR code or clicks a link, create links with their QR codes, and write data back on the visitor with Identify. Installation, the credential, what the trigger receives, and the settings on the n8n page in Linkbreakers. ## Short answer Linkbreakers has a community node for n8n, `n8n-nodes-linkbreakers`. In n8n, open **Settings → Community Nodes**, choose **Install** and enter `n8n-nodes-linkbreakers`. Create a **Linkbreakers API** credential with a Linkbreakers API token, add the **Linkbreakers Trigger** to a workflow and activate it. From then on, each visit to your links, by scan or by click, starts the workflow. The **Linkbreakers** node also creates links with their QR codes, reads and deletes links, and identifies the visitor of a visit, for example to write back what your CRM knows about them. ## Quick summary - Package: `n8n-nodes-linkbreakers` on npm, installed as an n8n community node - **Linkbreakers Trigger**: starts a workflow on each visit, for every link or one **Link ID** - **Linkbreakers** node: Link (Create, Get, Get Many, Delete) and Visitor (Identify) - Credential: **Linkbreakers API**, with a token from **API Tokens** in the Linkbreakers dashboard - Which links, which moments and how much visitor data are sent is set on the n8n page in Linkbreakers, for all your n8n workflows - Your n8n must be reachable from the internet for the trigger to receive visits ## How it works Activating a workflow that starts with the Linkbreakers Trigger creates a webhook in Linkbreakers pointing at that workflow. Deactivating the workflow removes it. Each workflow connected this way is listed on the **n8n** page under **Integrations** in Linkbreakers. Linkbreakers then sends one delivery per step of a visit that the n8n settings cover. Each delivery becomes one item in your workflow. ## Connect n8n 1. In n8n, open **Settings → Community Nodes**, choose **Install** and enter `n8n-nodes-linkbreakers`. 2. In Linkbreakers, create a token under **API Tokens** in the dashboard. 3. In n8n, create a **Linkbreakers API** credential and paste the token in **API Token**. Leave **API URL** as it is. n8n checks the credential against your workspace when you save it. 4. Add the **Linkbreakers Trigger** to a workflow and activate it. It appears on the n8n page in Linkbreakers, and the settings there apply to all your n8n workflows. ## What the trigger receives Each item is one delivery, in the same format as a [Linkbreakers webhook](/help/article/how-do-webhooks-work-in-linkbreakers): - `type`: the moment of the visit: `visit.entered`, `visit.interacted`, `visit.routed` or `visit.exited` - `data.event`: the visit, with the link, the device, the visitor and the journey - `data.step`: the workflow step that was reached - `data.lbid`: the visit's ID, to pass to **Visitor → Identify** - `data.visitorAttributes`: the visitor data the n8n page's **What is sent** setting allows Set **Link ID** on the trigger to receive the visits of one link only. Leave it empty to follow the settings on the n8n page. ## The Linkbreakers node | Resource | Operation | What it does | |---|---|---| | Link | **Create** | Creates a trackable link and its QR code from a **Destination**, with an optional **Name**, **Shortlink**, **Tags** and **Wait for QR Code** | | Link | **Get** | Reads one link by **Link ID** | | Link | **Get Many** | Lists your links, up to a **Limit** | | Link | **Delete** | Deletes a link by **Link ID** | | Visitor | **Identify** | Adds **Company**, **Email**, **First Name**, **Last Name**, **Phone**, **Title** and **Custom Attributes** to the visitor of a visit, by its **LBID**. **Set Only Empty Fields** keeps values the visitor already has | For example: a Linkbreakers Trigger, then a lookup in your CRM, then **Visitor → Identify** to save the company on the visitor who scanned. ## Which visits reach your workflows The n8n page in Linkbreakers has the same three settings as the other integrations, and they apply to all your n8n workflows at once: - **Where**: every link, or only some links, directories and tags - **When**: the moments of a visit (Entry, Interaction, Routing, Exit), or specific steps - **What is sent**: just the visit, the visit and all visitor data, or the visit and only some visitor data **Pause** stops sending to every n8n workflow, and **Activate** starts again. Visits past your plan's tracked visits allowance are not sent. ## Limits and caveats - **n8n must be reachable from the internet.** Linkbreakers posts to your workflow's webhook URL; a private n8n needs a reverse proxy or a tunnel - **n8n Cloud only installs community nodes that n8n has verified.** The Linkbreakers node is waiting for that review, so install it on a self-hosted n8n for now. On n8n Cloud, use an n8n **Webhook** node with a [Linkbreakers webhook](/help/article/how-do-webhooks-work-in-linkbreakers) instead - **One setting for all workflows.** Where, When and What is sent are shared by every n8n workflow - **Each workflow with the trigger is a webhook** and counts toward your plan's webhook limit - **Links cannot be updated** from the node; Create, Get, Get Many and Delete only ## Frequently asked questions ### Do I still need an n8n Webhook node to receive Linkbreakers visits? No. Use the Linkbreakers Trigger: it subscribes and unsubscribes the webhook for you. A Webhook node with a Linkbreakers webhook still works, for example on n8n Cloud. ### Where do I create the API token? Under **API Tokens** in the Linkbreakers dashboard. See [API token scopes](/help/article/api-token-scopes) to limit what it can do. ### Can one workflow follow only one link? Yes. Set **Link ID** on the Linkbreakers Trigger. ### How do I save data from another tool on the visitor? Pass `data.lbid` from the trigger to **Visitor → Identify**, with the fields you want to save. ### Does my visitor data pass through a third party? Not when your n8n is self-hosted: Linkbreakers sends each delivery straight to your n8n. ## Sources - Linkbreakers n8n integration page and the `n8n-nodes-linkbreakers` package (trigger, node and credential), checked on 2026-11-09. - n8n, installing community nodes: https://docs.n8n.io/integrations/community-nodes/installation/ ## Last reviewed 2026-11-09 by Laurent Schaffner.