Create, re-point and manage QRSalt dynamic QR codes and short links, render QR codes and barcodes as files, and read scans, analytics, menus and form responses.
Explore 31 workflow actions for QRSalt, including account permissions and operation limits.
18 read actions13 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add a domain
Write
Adds a domain you own, like go.yourbrand.com. It starts PENDING. Add the two records in dns; we check every few minutes, or check it now. Owners and admins only. How many domains you can add depends on your plan.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Bulk actions on codes
Write
Change up to 500 codes in one request, as the bulk bar on the Codes page does. Send ids and an action.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Check domain DNS now
Write
Checks the records now: the same check as Check DNS now in the dashboard, once every 30 seconds per domain. meta.verified says whether it passed and meta.error what is missing.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Check key
Read
Answers with the workspace a key acts for, and what that workspace is allowed to do. Call it when somebody pastes a key in, to tell them straight away whether it works.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Create a dynamic code
Write
Saves a code to your account, as if you had made it in the dashboard: the same checks on the destination, the same plan limits and the same history. It works for every type.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a code
Write
Your key needs the delete scope, and no key has it unless somebody ticked that box. You can’t undo this call, so only a key made with that permission can make it.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Get a code
Read
One of your codes, with its short link and scan count. Another workspace's id is a 404.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Get a code's image
Read
Your code as an image, with its saved colours, shapes and logo, and no frame. A dynamic code encodes its short link (on your custom domain if it has one); a static code encodes its content.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Get a domain
Read
One domain, with its status, records and the number of codes on it. lastError says why the last check failed.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Get a folder
Read
One folder, with how many codes it holds. To see the codes themselves, use List codes with folderId.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Get a tag
Read
One tag, with how many codes carry it. For the codes themselves, use List codes with tag and the name.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Get code scans
Read
Daily scans and unique visitors for one code, and one optional breakdown. The date range can’t go back further than your plan keeps scan history, and the answer says when the range was cut short.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Get workspace analytics
Read
Scans across every code in your workspace: the same numbers as the Analytics page in the dashboard, with the same plan rules.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List campaign presets
Read
The campaign-tag presets saved in the dashboard, for action: "utm" in Bulk actions. To set campaign tags on a single code, send the values in utm instead.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List codes
Read
Everything you have made, newest first, a page at a time: QR codes and short links together. meta.nextOffset is the offset of the next page, or null. For the short links on their own, use GET /api/v1/links under Shorten a link.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List custom domains
Read
Your custom domains, with their status and the DNS records to add. meta.limit is how many your plan includes; meta.defaultDomain is the domain new codes get, or null for ours.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List folders
Read
Your folders, with how many codes each holds. POST the same path with a name to make one. File codes with folderId on Create and Update, or many at once with Bulk actions. One folder is read, renamed and removed at /api/v1/folders/{id}.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List form responses
Read
A form's answers, newest first, a page at a time. answers is keyed by question id; meta.questions names each one. Answers are personal data your form collected, so keep them as carefully as you would the CSV.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List QR Forms
Read
Your QR Forms, read-only, with their response counts. Read the answers with Form responses, or get each one as it arrives with the form.submitted webhook.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List QR Menus
Read
Your QR Menus, read-only: title, public address, whether it is published, and views. Build and edit them in the dashboard.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
List tags
Read
Your tags, with how many codes carry each. Tags are made by naming them: tags on a code, or add in Bulk actions. Filter the list of codes with ?tag=. One tag is read, renamed and removed at /api/v1/tags/{id}.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Remove a domain
Write
Removes a domain. Its codes move back to our domain, where their short code always worked; copies printed with this domain stop working. When codes use it, send confirm with the hostname, as the dashboard asks you to type it.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove a folder
Write
Removes the folder. The codes in it are not deleted: they move to no folder in the same write, and keep their destination, their short link and their scans. codesUnfiled says how many moved. The dashboard can undo it for 24 hours.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove a tag
Write
Removes the tag and takes the word off every code that carried it. Those codes are not deleted and nothing else about them changes. codesUntagged says how many lost the word.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename a folder
Write
Changes the name. The codes in it stay where they are. A name your workspace already uses is refused rather than merged into.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Rename a tag
Write
Changes the word on every code that carries it. A name another tag already has is refused, not merged, because a merge would change which codes carry which tag and could not be undone. Delete one of the two tags instead.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Render barcode
Read
Draws a barcode in one of 12 symbologies and returns the image. Nothing is stored.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Render QR code
Read
Returns a static QR code image file for the exact text you send. Nothing is stored and there is no short link.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
Set the default domain
Write
Make a verified domain the default: new codes and links get it unless you send domain. false puts new codes back on our domain. Codes you already made stay where they are. Owners and admins only.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Shorten a link
Write
Makes a short link and saves it to your account.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update or re-point a code
Write
Rename a code, change where a dynamic code points, pause and resume it, move it to a domain, change its custom link, file it, tag it or set its campaign tags. Send only what changes.
Permissions and limits
Account permissions
A QRSalt API key (Starter and above for account calls; render, read, write and delete scopes)
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in QRSalt. A saved workflow is not a completed provider action.