{"id":454,"date":"2023-04-22T23:03:58","date_gmt":"2023-04-22T22:03:58","guid":{"rendered":"https:\/\/www.help.headlight.tech\/?post_type=ht_kb&#038;p=454"},"modified":"2026-01-20T11:22:57","modified_gmt":"2026-01-20T10:22:57","slug":"how-do-i-configure-workflow-triggers","status":"publish","type":"ht_kb","link":"https:\/\/www.help.headlight.tech\/?ht_kb=how-do-i-configure-workflow-triggers","title":{"rendered":"How do I configure workflow triggers?"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">What are workflow triggers?<\/h2>\n\n\n\n<p>Workflow triggers are the initial events that trigger your workflows. As a user, you configure what those triggers are. Often, triggers are connected to events that occur in the platform, such as the activation as a user&#8217;s ability to order a car. <\/p>\n\n\n\n<p>It is possible to add multiple triggers for one workflow. Below we describe the different trigger types that are available in Headlight.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Adding triggers<\/h2>\n\n\n\n<p>When you create a workflow, a trigger component is automatically added. In the workflow configurator, below the workflow visualisation, a set of cards show the different components of the workflow. The first one is the trigger. When you click the card, a configuration screen opens. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"597\" src=\"https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-1024x597.png\" alt=\"\" class=\"wp-image-455\" srcset=\"https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-1024x597.png 1024w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-300x175.png 300w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-768x447.png 768w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-50x29.png 50w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-1536x895.png 1536w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-60x35.png 60w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03-100x58.png 100w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.38.03.png 1634w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Trigger configuration screen<\/figcaption><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Manual workflow triggers<\/h2>\n\n\n\n<p><br>When you select &#8220;Manual trigger&#8221; as trigger type, the workflow can be triggered manually by users. However, not everyone is able to trigger every workflow. You can choose to limit the ability to launch the workflow to specific roles: company admin and employee. <\/p>\n\n\n\n<p>If a user has a role that is allow to trigger a specific workflow, it will be shown in the <a rel=\"noreferrer noopener\" href=\"https:\/\/app.headlight.tech\/app\/workflow-triggers\" data-type=\"URL\" data-id=\"https:\/\/app.headlight.tech\/app\/workflow-triggers\" target=\"_blank\">trigger workflows screen<\/a>.<\/p>\n\n\n<p><!--ARCADE EMBED START--><\/p>\n<div style=\"position: relative; padding-bottom: calc(55.0232% + 41px); height: 0px; width: 100%;\"><iframe src=\"https:\/\/demo.arcade.software\/mOkOvx5aw5qA3L9XGjNU?embed&amp;embed_mobile=tab&amp;embed_desktop=inline&amp;show_copy_link=true\" title=\"Workflow components: Manual Triggers\" frameborder=\"0\" loading=\"lazy\" webkitallowfullscreen=\"\" mozallowfullscreen=\"\" allowfullscreen=\"\" allow=\"clipboard-write\" style=\"position: absolute; top: 0; left: 0; width: 100%; height: 100%; color-scheme: light;\"><\/iframe><\/div>\n<p><!--ARCADE EMBED END--><\/p>\n\n\n<h2 class=\"wp-block-heading\">Automatic workflow triggers<\/h2>\n\n\n\n<p>When you select &#8220;Automatic trigger&#8221; as trigger type, you must select the applicable trigger source. This means nothing more than the event or context in which the workflow should be started. <\/p>\n\n\n<p><!--ARCADE EMBED START--><\/p>\n<div style=\"position: relative; padding-bottom: calc(55.0232% + 41px); height: 0px; width: 100%;\"><iframe src=\"https:\/\/demo.arcade.software\/t1O148712QnTp7ktC9EU?embed&amp;embed_mobile=tab&amp;embed_desktop=inline&amp;show_copy_link=true\" title=\"Workflow components: Automatic Triggers\" frameborder=\"0\" loading=\"lazy\" webkitallowfullscreen=\"\" mozallowfullscreen=\"\" allowfullscreen=\"\" allow=\"clipboard-write\" style=\"position: absolute; top: 0; left: 0; width: 100%; height: 100%; color-scheme: light;\"><\/iframe><\/div>\n<p><!--ARCADE EMBED END--><\/p>\n\n\n<h3 class=\"wp-block-heading\">Trigger source: Workflow<\/h3>\n\n\n\n<p>It is possible for you to developed nested workflows. In other words, you can build processes that trigger subprocesses. For example, you might have an onboarding process, which includes a subprocess to order a new charging card. In order to achieve this, you need to set the trigger of the process as &#8220;workflow&#8221;. In addition, you can identify the <a href=\"https:\/\/www.help.headlight.tech\/?ht_kb=what-are-workflow-parameters\" data-type=\"URL\" data-id=\"https:\/\/www.help.headlight.tech\/?ht_kb=what-are-workflow-parameters\" target=\"_blank\" rel=\"noreferrer noopener\">parameter references<\/a> that you will hand over from the parent workflow to the subworkflow. <\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Trigger source: Periodic<\/h3>\n\n\n\n<p>You can schedule workflows to be initiated at recurring intervals: daily, on weekdays, weekly, monthly, etc. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"463\" src=\"https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-1024x463.png\" alt=\"\" class=\"wp-image-471\" srcset=\"https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-1024x463.png 1024w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-300x136.png 300w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-768x347.png 768w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-50x23.png 50w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-60x27.png 60w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31-100x45.png 100w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-22-at-23.58.31.png 1172w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Periodic trigger configuration<\/figcaption><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Event-based trigger sources<\/h3>\n\n\n\n<p>Aside from workflow and periodic triggers, you can select as a trigger source a set of events that take place in the application. For instance, whenever an account is enabled to order a vehicle, or when someone first logs in, or when someone&#8217;s lease contract is close to its end, &#8230; <\/p>\n\n\n\n<p>When you select an event-based trigger source, you will find the parameters that the event will provide to the workflow below the configuration. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"485\" src=\"https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-1024x485.png\" alt=\"\" class=\"wp-image-487\" srcset=\"https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-1024x485.png 1024w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-300x142.png 300w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-768x363.png 768w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-50x24.png 50w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-60x28.png 60w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46-100x47.png 100w, https:\/\/www.help.headlight.tech\/wp-content\/uploads\/2023\/04\/Screenshot-2023-04-23-at-00.04.46.png 1082w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Other trigger sources<\/h3>\n\n\n\n<p>Some use cases require workflows to be triggered by external sources. Headlight has APIs through which workflows can be initiated. Talk to <strong>support<\/strong> in order to receive access.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>What are workflow triggers? Workflow triggers are the initial events that trigger your workflows. As a user, you configure what those triggers are. Often, triggers are connected to events that occur in the platform, such as the activation as a user&#8217;s ability to order a car. It is possible to&#8230;<\/p>\n","protected":false},"author":2,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[94],"ht-kb-tag":[43],"_links":{"self":[{"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=\/wp\/v2\/ht-kb\/454"}],"collection":[{"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=454"}],"version-history":[{"count":12,"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=\/wp\/v2\/ht-kb\/454\/revisions"}],"predecessor-version":[{"id":2275,"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=\/wp\/v2\/ht-kb\/454\/revisions\/2275"}],"wp:attachment":[{"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=454"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-category&post=454"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.help.headlight.tech\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-tag&post=454"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}