{"id":5764,"date":"2022-02-23T08:00:50","date_gmt":"2022-02-23T08:00:50","guid":{"rendered":"https:\/\/www.process.st\/help\/docs\/workflow-run-link\/"},"modified":"2026-05-22T09:52:13","modified_gmt":"2026-05-22T09:52:13","slug":"workflow-run-link","status":"publish","type":"ht_kb","link":"https:\/\/www.process.st\/help\/docs\/workflow-run-link\/","title":{"rendered":"Workflow Run Link"},"content":{"rendered":"<p>A &#8220;Workflow Run Link&#8221; is a link that, when clicked runs your <a href=\"https:\/\/www.process.st\/help\/docs\/templates\/\">Workflow<\/a>.<\/p>\n<p>This allows you, or another person to quickly <a href=\"https:\/\/www.process.st\/help\/docs\/running-checklists\/\">run a workflow<\/a>\u00a0from anywhere you have shared the link.<\/p>\n<p>Run links can also be used to help integrate your Workflow runs with other apps.<\/p>\n<h3>Ways to use Workflow run links<\/h3>\n<ul>\n<li>To integrate with other apps such as your <a href=\"https:\/\/www.process.st\/?s=crm\">CRM<\/a> or Support System<\/li>\n<li>To link multiple Workflows together<\/li>\n<li>To send to a customer automatically to complete via email<\/li>\n<li>To add to your email signature or social media channels to capture new leads<\/li>\n<li>To send as a survey to your email list<\/li>\n<li>To send to a <a href=\"https:\/\/www.process.st\/help\/docs\/managing-members\/\">member<\/a> of your team in a chat<\/li>\n<li>To store in a document<\/li>\n<\/ul>\n<p><em><strong><i>Users: In order to create Workflow Run Links, you must be an Administrator or a <a href=\"https:\/\/www.process.st\/help\/docs\/what-is-a-full-member\/\">Builder<\/a> who has been given <\/i><i>\u2018edit\u2019<\/i><i> access by your Administrator.<\/i><\/strong><\/em><\/p>\n<p><em><strong>Note: Run links are available only on the paid plans. If you&#8217;re unable to create a run link, please contact our <a href=\"https:\/\/www.process.st\/help\/docs\/support\/\">support team<\/a>.<\/strong><\/em><\/p>\n<h2>Workflow Run Link example<\/h2>\n<p><iframe loading=\"lazy\" title=\"YouTube video player\" src=\"https:\/\/www.youtube.com\/embed\/p_8hL3ifsq8\" width=\"100%\" height=\"406\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><span data-mce-type=\"bookmark\" style=\"display: inline-block; width: 0px; overflow: hidden; line-height: 0;\" class=\"mce_SELRES_start\">\ufeff<\/span><\/iframe><\/p>\n<h2>How to create a basic Workflow run link<\/h2>\n<h3>From a Workflow&#8217;s menu<\/h3>\n<p>To generate a Workflow run link, first navigate to the Workflow you want the create the run link for in your <a href=\"https:\/\/www.process.st\/help\/docs\/template-dashboard\/\">library<\/a>.<\/p>\n<p>Click the <strong>three dots (&#8230;)\u00a0<\/strong>next to your Workflow&#8217;s name, then select &#8220;<strong>Workflow Run Link<\/strong>&#8221; and check the appropriate permission for sharing.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-13859\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/run-link.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>In the example above, we&#8217;ve chosen the permission &#8220;Anyone can run this Workflow&#8221; (learn more about permissions below).<\/p>\n<p><strong>Copy<\/strong> your run link and click &#8220;<strong>Done<\/strong>&#8221; when you&#8217;re finished.<\/p>\n<p><strong>Pro tip:<\/strong> You can also click on the Permission Icons next to your Workflow name to open the share options directly.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-13858\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/permission-icons.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>You can now add this run link into another Workflow (which effectively links your processes together) into a document, your CRM, your support center, or anywhere else you need it.<\/p>\n<p>A new Workflow run will be created every time the link is clicked. If you&#8217;d like to <em>pre-fill data<\/em> in your Workflow run each time the link is clicked, you can do that too via an integration.<\/p>\n<h3>When manually running a Workflow<\/h3>\n<p>You can also\u00a0copy a <a href=\"https:\/\/www.process.st\/help\/docs\/workflow-run-link\/\">run link<\/a> when you manually run it from viewing the Workflow, as shown below.<\/p>\n<p>The permission for who can use the run link depends on what you have set in the run link sharing options.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-13860\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/run-via-workflow.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<h2>Adding Workflow widgets into Pages<\/h2>\n<p>You can add Workflow widgets into your <a href=\"https:\/\/www.process.st\/help\/docs\/pages\/\">Pages<\/a> to allow your team to efficiently run Workflows at the point they&#8217;re needed.<\/p>\n<p>For example, your paid time off policy page could have a run link to your PTO approval Workflow, or your remote work policy could have a run link to your Remote work approval process, as shown below.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-12548\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/ps-workflow-widget-page.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>To insert the Workflow widget into your Page, click on the <strong>+\u00a0<\/strong>icon. Then from the list of options, click\u00a0<strong>Workflow<\/strong>. You can enter the Workflow name in the search box and when you select the desired Workflow, it will get added.<\/p>\n<p>You can test the widget by clicking on the\u00a0<strong>Run<\/strong> button once the Workflow has been added to the Page, as shown below.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-12540\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/run-link-insert-workflow-in-page.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<h2>Integrating Workflow run links with other apps<\/h2>\n<p>As with many other aspects of <a href=\"https:\/\/www.process.st\/\">Process Street<\/a>, integrating your Workflow run links with other apps makes them even more powerful.<\/p>\n<p>For example, you could integrate the run link with your CRM in order to automatically populate the new run with data, such as your client&#8217;s name, company, or email address. This saves valuable time and prevents data entry errors since when you run the Workflow, some of the <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">form fields<\/a> in your run will already be filled out with your data.<\/p>\n<p>To set this up, you&#8217;re going to need to add <a href=\"https:\/\/www.process.st\/help\/docs\/variables\/\">variables<\/a> into your run link, but before we get to variables, let&#8217;s first check you have some form fields in your Workflow.<\/p>\n<h3>Step 1: Adding form fields<\/h3>\n<p>If you are using a <a href=\"https:\/\/www.process.st\/help\/docs\/template-gallery\/\">premade Workflow template<\/a>, chances are there will already be a number of <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">form fields<\/a> in your Workflow. If not, or if you don&#8217;t have the right fields set up already, you&#8217;re going to need to add some.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-14180\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/form-field.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Form fields such as email addresses, names or ID numbers can be added to your Workflows to allow you to use them as <a href=\"https:\/\/www.process.st\/help\/docs\/variables\/\">variables<\/a> in your run link.<\/p>\n<p><a href=\"https:\/\/www.process.st\/help\/docs\/editing-templates\/\">Edit your Workflow<\/a>\u00a0and drag and drop the required form fields into the relevant task\/s. Give the form fields a label, for example, &#8220;Employee name&#8221; or &#8220;Project start date&#8221; or &#8220;Client website&#8221;.<\/p>\n<p><strong>Note:<\/strong> Make sure that your form field labels are unique from one another, as this will enable you to find the correct one later when looking for and adding variables. For example, don&#8217;t just use &#8220;name&#8221; in various form fields, try using &#8220;client name&#8221; or &#8220;employee name&#8221; or manager name&#8221; for each different label.<\/p>\n<p>Add as many form fields as you need in your Workflow and click &#8220;<strong>Publish<\/strong>&#8221; when you&#8217;re finished.<\/p>\n<h3>Step 2: Adding variables<\/h3>\n<p>Now that you&#8217;ve saved changes to your Workflow, you can start adding variables into your run link.<\/p>\n<p>Click the <strong>three dots (&#8230;)\u00a0<\/strong>next to your Workflow&#8217;s name and from the dropdown menu, click &#8220;<strong>Workflow Run Link<\/strong>&#8221; to open the run link menu.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-14181\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/run-link-variables.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Next, click &#8220;<strong>Link options<\/strong>&#8221; and then &#8220;<strong>+ Add variable<\/strong>&#8220;. A dropdown list appears with your choice of variables, as shown above.<\/p>\n<p>Select the variables you want to use in your run link, one at a time. You can add as many as you require in your run link. Each time you add a variable, your run link starts to build.<\/p>\n<p><strong>Note:<\/strong> &#8220;Run_name&#8221; is always a variable option, and any variable with the prefix &#8220;form.&#8221; are the form fields you added to your Workflow earlier.<\/p>\n<p>For example, if you add the variable &#8220;<strong>run_name<\/strong>&#8220;, this will be added to your run link: &#8220;<strong>run_name=XXX<\/strong>&#8221; or if you add the variable &#8220;<strong>form.New_Hire_First_Name<\/strong>&#8221; then this will be added to your run link: &#8220;<strong>form.New_Hire_First_Name=XXX<\/strong>&#8221;<\/p>\n<p>Once you&#8217;ve finished adding variables, <strong>Copy<\/strong> your run link and click &#8220;<strong>Done<\/strong>&#8221; to finish.<\/p>\n<h3>Step 3: Populating variables &amp; hyperlink your run link<\/h3>\n<p>To populate <a href=\"https:\/\/www.process.st\/help\/docs\/variables\/\">variables<\/a> with information when your Workflow runs, you need to change the &#8220;XXX&#8221; entries in your run link to match the data you want to pass into your new Workflow run.<\/p>\n<p>In the example below, we&#8217;re creating the run link in another Workflow, inside a <a href=\"https:\/\/www.process.st\/help\/docs\/text-widget\/\">text field<\/a>.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-14182\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/run-link-with-variable.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Start by pasting your run link into the text field so you can see it in full.<\/p>\n<p>Highlight one of the places where you have &#8220;<strong>XXX<\/strong>&#8221; and then click the <strong>magic wand icon<\/strong> to search for the fields to populate the &#8220;<strong>XXX<\/strong>&#8221; entries with. In the example above, we&#8217;re using the candidate&#8217;s name and email address.<\/p>\n<p>The resulting run link will look something like this (with variables in bold):<\/p>\n<p>https:\/\/app.process.st\/workflows\/Customer-Support-ulawzIgw_vJtjafWK_dCPQ\/run-link?<strong>form.Jira_ticket_number=XXX<\/strong>&amp;<strong>run_name=XXX<\/strong><\/p>\n<p>Once you have changed all the XXX&#8217;s in your run link to variables, you can hyperlink the run link into your text.<\/p>\n<p>Select and cut the whole run link, ready to paste. Next, highlight the text you&#8217;d like to link to, and click the <strong>link<\/strong> <strong>icon<\/strong>. Paste the run link into the URL field. Click <strong>OK<\/strong> to finish and publish your Workflow (the gif above shows you how to do this).<\/p>\n<p>This creates a nice-looking, clickable link in your Workflow and Workflow runs.<\/p>\n<h3>Create a Workflow run name using two variables<\/h3>\n<p>You can add two variable fields together in a run link. For example, if you want to put both the candidate&#8217;s name and their ID number into the new Workflow run&#8217;s name, this is possible. Add a <strong>+<\/strong> symbol between the two fields in your run link and this will add both fields to your Workflow run&#8217;s name when it is created.<\/p>\n<p>For example: &#8230;run_name={{form.Intern_full_name}}<strong>+<\/strong>{{form.Intern_ID_number}}&#8230;<\/p>\n<h3>Which form fields can you use in run links?<\/h3>\n<p>Note that you can only push data into a Workflow run name or the following <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">form fields<\/a>:<\/p>\n<ul>\n<li>Short text fields<\/li>\n<li>Long text fields<\/li>\n<li>Dropdown fields<\/li>\n<li>Email fields<\/li>\n<li>Web addresses<\/li>\n<li>Number fields<\/li>\n<li>Hidden fields<\/li>\n<\/ul>\n<h3>Which fields don&#8217;t work in run links?<\/h3>\n<p>You cannot use date fields in Workflow run links, due to issues with passing through date formatting. However, you can work around this by using a short text field and enter the date there manually instead.<\/p>\n<p>Multi-choice fields cannot be used in run links.<\/p>\n<h3>Limitations<\/h3>\n<p><strong>Special characters:<\/strong> Note that some special characters will not work in run links, for example $ \u00a3 ! @ % ^ &amp; * \/ |. You can use # in run links, however.<\/p>\n<p><strong>Run link size:<\/strong> We recommend a maximum URL character limit of 2000 characters, to allow your run links to work. If your run links are over that size we cannot guarantee they will work.<\/p>\n<p><strong>Data Sets:<\/strong> Data Set variables are not supported in run links.<\/p>\n<h2>Manage Workflow run link permissions<\/h2>\n<p>You can control who can use your run links and run your Workflows, by setting the permissions.<\/p>\n<h3>Only organization members can run this Workflow<\/h3>\n<p><a href=\"https:\/\/www.process.st\/help\/docs\/user-permissions\/\">Admins and Builders<\/a> can run this Workflow from a run link when you use this permission setting.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-10129\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Only-organization-members.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>This permission setting does not allow guests to create run links, so you need to use the permission setting shown below for them or other external users.<\/p>\n<h3>Anyone can run this Workflow<\/h3>\n<p>If you choose this permission setting, all runs created from this link will automatically be <a href=\"https:\/\/www.process.st\/help\/docs\/checklist-sharing\/\">shared<\/a>, and anyone with the link will be able to run the Workflow and interact with it. <em>They don&#8217;t even need a Process Street account. <\/em><\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-10130\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Anyone-can-run.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>This is a great way to run surveys or collect information from customers, leads, or even new hires before they start their first day.<\/p>\n<p>Note: <em>Anyone<\/em> using a run link with this permission set, will appear as an <a href=\"https:\/\/www.process.st\/help\/docs\/anonymous\/\">anonymous user.<\/a><\/p>\n<h2>Run link integration examples<\/h2>\n<p>Integrating Workflow runs and their run links can be confusing at first, so let&#8217;s run through two examples of how this can be done.<\/p>\n<h3>Example 1: Pulling data from a CRM<\/h3>\n<p><iframe loading=\"lazy\" src=\"https:\/\/www.youtube.com\/embed\/WDMAeXNzqM4\" width=\"100%\" height=\"406\" frameborder=\"0\" allowfullscreen=\"allowfullscreen\"><\/iframe><\/p>\n<p>See our full help article on <a href=\"https:\/\/www.process.st\/help\/docs\/close-io\/\">integrating Close.io and Process Street<\/a>.<\/p>\n<p>Let&#8217;s say that you have a <a href=\"https:\/\/www.process.st\/help\/docs\/sales\/\">sales<\/a> qualification process, and have created a run link with variables for your customer&#8217;s email and their name.<\/p>\n<p>After setting up the run link, you would need to go into your CRM (in this case we&#8217;re using Close.io) and add a new integration link.<\/p>\n<p>Paste your run link into the new integration link field, make sure that the &#8220;type&#8221; of link is correct (in our case, this could be a &#8220;Contact&#8221; link) and take note of where the variables (eg, &#8220;Customer_Email=XXX&#8221;) in that link are.<\/p>\n<p>You now need to replace the &#8220;XXX&#8221; entries with the correct code for those variables, as shown by your CRM.<\/p>\n<p>In our case, &#8220;Customer_Email=XXX&#8221; needs to be changed to &#8220;Customer_Email=[[contact.primary_email]]&#8221;, and &#8220;Customer_Name=XXX&#8221; becomes &#8220;Customer_Name=[[contact.name]].<\/p>\n<p>This will give you a new run link which, when clicked while you&#8217;re viewing a customer in your CRM, will run the Workflow and automatically pass over the data in the variables that you&#8217;ve set.<\/p>\n<h3>Example 2: Using an email marketing tool<\/h3>\n<p>You can include a run link in emails sent using tools such as Mailchimp to allow the recipient to run the Workflow, but by including variables in your link, they can save time by not having to fill out details like their name and email address.<\/p>\n<p>The run link can be pasted or anchored to text just like any other hyperlink, but to populate your variables (your &#8220;XXX&#8221;s) you&#8217;ll need to use your tool&#8217;s merge tags.<\/p>\n<p>For example, Mailchimp&#8217;s merge tabs for the recipient&#8217;s first name and email address are |FNAME| and |EMAIL|, respectively.<\/p>\n<p>Once you have these merge tags, replace the &#8220;XXX&#8221;s in your Workflow run link with the correct ones and then your link is ready to go. Anyone clicking that link from your email will run the workflow, with their information automatically added in for them.<\/p>\n<p>To learn more, see our articles on <a href=\"https:\/\/www.process.st\/help\/docs\/variables\/\">variables<\/a>, <a href=\"https:\/\/www.process.st\/help\/docs\/global-variables\/\">global variables<\/a> and <a href=\"https:\/\/www.process.st\/help\/docs\/running-checklists\/\">running Workflows.<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>A &#8220;Workflow Run Link&#8221; is a link that, when clicked runs your Workflow. This allows you, or another person to quickly run a workflow\u00a0from anywhere you have shared the link. Run links can also be used to help integrate your Workflow runs with other apps. Ways to use Workflow run links To integrate with other [&hellip;]<\/p>\n","protected":false},"author":3,"template":"","meta":{"_acf_changed":false,"available_plan":"All plans","available_product":"Workflows","footnotes":""},"ht_kb_category":[201,168],"ht_kb_tag":[216,187,160],"class_list":["post-5764","ht_kb","type-ht_kb","status-publish","hentry","ht_kb_category-sharing","ht_kb_category-run-workflows","ht_kb_tag-sharing","ht_kb_tag-workflow-runs","ht_kb_tag-workflows"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5764","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/users\/3"}],"version-history":[{"count":4,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5764\/revisions"}],"predecessor-version":[{"id":10019,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5764\/revisions\/10019"}],"wp:attachment":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/media?parent=5764"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_category?post=5764"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_tag?post=5764"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}