CodeQR

Generate and restyle dynamic QR codes, repoint short links, and read scan analytics with CodeQR. Agents mint trackable codes per campaign and retarget them without reprinting anything.

2 triggers 31 actions API key available

Platform Documentation ↗ Capability data verified 2026-07-31

On QR Code Scanned fires for a printed code whose destination has started returning errors

Get QR Code returns the code's current destination, folder, tags and accumulated scan counters

List Events counts how much live traffic reached the broken page in the last hour, and from which cities

The agent confirms the proposed replacement URL resolves and belongs to the same campaign as the code

The change is staged against the code and held rather than applied

The campaign owner receives the scan volume, the current destination and the proposed replacement side by side

The owner approves, and Update QR Code repoints the printed code in place, keeping its scan history intact

What This Integration Enables

CodeQR is built around one asymmetry: the printed thing is permanent and the destination behind it is not. Update QR Code changes where a code sends people while the artwork on the poster, the ticket or the table tent stays exactly as it was, and the accumulated scan history stays attached. That single property is what makes a printed code worth automating at all, because it means a decision made at print time is no longer final.

FlowRunner agents work both surfaces CodeQR exposes, QR codes and short links, through the same workspace. They mint codes one at a time or up to a hundred per call, apply device and country targeting, expiry and password rules, file everything into folders and tags, publish on a branded short domain, and read the results back either aggregated through Get Analytics or as raw individual events through List Events. Two triggers make the traffic itself a starting point: On QR Code Scanned emits one event per scan, and On New QR Code fires when a code is created in the workspace. The agent handles the minting, the tidying and the reporting. The moment where a repoint changes what a person sees on their next scan is the moment it hands the decision to somebody.

Without FlowRunner

A wrong destination means a reprint Fixing where a printed code points requires new artwork and a new print run

Scan data arrives as a monthly export Nobody learns a code is broken until someone opens the dashboard

Codes accumulate without structure Campaign codes, client codes and test codes sit in one undifferentiated list

With FlowRunner

The artwork is permanent, the destination is not A live code is repointed in place and its scan history carries forward

A scan is a workflow event Traffic on a code can start work the moment it happens, not at the end of the month

Inventory stays navigable Folders, tags and filters make a large estate of codes queryable by campaign or client

Use Case Scenarios

A tracked code per item, generated at catalog scale

A product line, a ticket run or a table map all share the same shape: many physical things, each needing its own code. The agent reads the source records from Shopify or a Google Sheets tab, calls Bulk Create QR Codes in batches of up to a hundred with the item identifier as the slug and the launch tag attached, and writes each generated image URL and short link back to the source row for the print file. Because bulk creation does not fire webhook events and does not accept custom designs, the agent applies a reusable template instead and confirms the batch with Count QR Codes rather than waiting for notifications.

Reacting to a scan while the person is still standing there

At a trade booth or on a shelf, a scan is a live signal with a short shelf life. On QR Code Scanned delivers the timestamp, destination, city, device, browser and referrer for each scan as it lands. The agent enriches the event with the code's tags to identify the booth or the store, posts a message to the sales channel in Slack, and writes the touch onto the matching record in HubSpot. The report the team used to read on Monday now arrives while the aisle is still busy.

Repointing a live print run mid-campaign

A landing page is retired, moved or breaks, and the code pointing at it is already on ten thousand printed pieces. The agent notices through the scan stream, pulls the last hour of List Events to size the exposure, verifies the replacement URL, and stages an Update QR Code call. It does not apply it. The campaign owner sees how many people have already hit the broken page and where the traffic is coming from, then approves the new destination. The next scan goes to the right place, and the code's history stays whole.

Human-in-Loop Highlight

Repointing a live code is not a reversible action in the way an API description makes it sound. The change takes effect on the very next scan, and every person who scanned during the window in between is gone. You cannot reach them and you cannot tell them to try again. So when a repoint is proposed on a code that is currently receiving traffic, the agent stops and posts to Slack: "Code MENU-TABLE-12 has taken 47 scans in the last hour, all from the restaurant's city. Its destination returns a 404. Repoint to the new menu URL now? Confirm and the next scan goes there." A person confirms, and the agent applies it in one call. The same gate covers the two operations in this connector with a blast radius larger than one code: Bulk Delete QR Codes removes up to a hundred codes and their history in a single request, and Delete Domain deletes every short link and QR code published under that domain. Neither is undoable, and neither runs unattended. That is what human-in-the-loop means in practice: the agent does the whole job and pauses at the operations that reach people it can no longer contact.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via Slack

Human decides

Agent resumes with decision

Agent Capabilities

31 actions

QR Codes

Create QR Code Creates a dynamic QR code supporting every CodeQR content type, full visual customization or a reusable template, device and country targeting, smart routing rules, expiry, password protection, tags and folders. Returns the code with its short link, image URL and scan counters.
Update QR Code Updates a code in place. Because CodeQR codes are dynamic, changing the destination keeps the printed artwork and its accumulated scan history intact. Only the parameters supplied are changed.
Upsert QR Code Creates a code, or returns and updates the existing one when a code with the same destination already exists. Used to keep replayed flows from littering the workspace with duplicates.
Get QR Code Retrieves the full record for one code, including destination, design settings, short link, scan counters and tags. Addressable by domain and key, by CodeQR ID, or by your own external ID.
List QR Codes Retrieves a paginated list with a rich filter set covering search, domain, tags, folder, creator, format, content type, scan count range, creation and expiry windows and UTM values. Used to audit or segment an estate.
Count QR Codes Returns how many codes match a filter without transferring the records. Used for quota checks, conditional branching and reporting, with Group By for a breakdown instead of a single total.
Bulk Create QR Codes Creates up to 100 codes in one request, far faster than looping when generating codes for a catalog, a guest list or a print run. Bulk creation does not support custom designs and does not fire webhook events.
Bulk Delete QR Codes Permanently deletes up to 100 codes in one request. Unknown IDs are ignored so the call is safe to retry, but the deletion itself cannot be undone.
Delete QR Code Permanently deletes one code and its analytics history. Printed copies stop resolving immediately. Archive the code instead when the goal is only to hide it.

Short Links

Create Short Link Creates a trackable short link with a custom domain and slug, device and country targeting, smart routing, expiry with a fallback URL, password protection, cloaking, custom social previews, tags and folders. The response includes the link and its generated QR image URL.
Update Short Link Updates a link without changing the shared URL, so material already in circulation keeps working and click history is preserved.
Upsert Short Link Creates a link, or returns and updates the existing one when a link with the same destination already exists. Used for idempotent flows that may run more than once for the same asset.
Get Short Link Retrieves one link's destination, targeting configuration, click, lead and sale counters, tags and QR image URL.
List Short Links Retrieves a paginated list with search, domain, tag, folder, creator, click count range, date window, UTM and presence filters.
Count Short Links Returns how many links match a filter without transferring the records, with an optional Group By breakdown.
Bulk Create Short Links Creates up to 100 links in one request. Used when importing a campaign spreadsheet or generating per recipient links. Does not fire webhook events.
Bulk Delete Short Links Permanently deletes up to 100 links in one request. Safe to retry, impossible to undo.
Delete Short Link Permanently deletes one link and its analytics history. The link stops redirecting immediately, so anything already published pointing at it breaks.

Analytics and Events

Get Analytics Retrieves aggregated analytics for a code, a link, a domain or the whole workspace, choosing the metric with Event and the breakdown with Group By, over an interval or an explicit date range.
List Events Retrieves the raw individual events behind the aggregates: every scan, click, view, lead or sale with its timestamp, destination, geography, device, browser, operating system and referrer. Used to stream scan level data into a warehouse or to audit traffic.

Tags and Folders

Create Tag Creates a tag so codes and links can be grouped by campaign, client, channel or product line. Tags become filter values across the listing and analytics operations.
Update Tag Renames a tag or changes its colour. Existing associations are kept, so a taxonomy can be reworked without re-tagging anything.
List Tags Retrieves the workspace tags, optionally filtered by search term or restricted to specific IDs. Used to resolve names to the IDs the other filters require.
Create Folder Creates a folder for organizing codes and links, with an access level controlling whether other workspace members can edit or only view.
Update Folder Renames a folder or changes its access level. Contents are unaffected.
List Folders Retrieves the workspace folders with their type and access level, optionally narrowed by search term.
Delete Folder Deletes a folder. Codes and links filed in it keep working and simply become unfiled, so this is a non-destructive way to reorganize.

Custom Domains

Add Domain Registers a custom short domain so codes and links can be branded. The domain still needs DNS verification in the CodeQR dashboard before it resolves.
Update Domain Renames a domain, changes its root redirect or expired link fallback, or archives and unarchives it. Existing links keep working unless the domain slug itself changes.
List Domains Retrieves the registered domains with DNS verification state, primary flag, root redirect behaviour and expired link fallback. Archived domains are excluded by default.
Delete Domain Removes a custom short domain and deletes every short link and QR code published under it, so anything already printed or shared stops resolving. Archive the domain instead when the goal is only to stop new links being created on it.

Triggers

2 triggers

Event Triggers

On QR Code Scanned Fires for every new scan recorded by CodeQR, optionally narrowed to a single code, carrying the timestamp, destination, continent, country, city, device, browser, operating system and referrer along with the record it belongs to. The first cycle establishes a baseline and emits nothing, so activating the trigger does not replay scan history.
On New QR Code Fires when a code is created in the workspace, optionally narrowed to a single domain, folder or tag, carrying the full record including its short link, image URL and design settings. Used to pick up codes minted by people in the dashboard and route them into an approval or reporting flow.

Frequently Asked Questions

What can FlowRunner do with CodeQR?

FlowRunner agents can run Create QR Code, Update QR Code, and Upsert QR Code in CodeQR, plus 28 more actions.

Does connecting CodeQR to FlowRunner require OAuth?

No. CodeQR connects to FlowRunner with an API key, no OAuth flow required.

Can CodeQR trigger a FlowRunner workflow automatically?

Yes. CodeQR supports 2 triggers that can start a FlowRunner workflow automatically.

Start building with CodeQR

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us