[{"data":1,"prerenderedAt":1035},["ShallowReactive",2],{"docs:en:\u002Fdocs\u002Fworkflows\u002Ftriggers":3},{"page":4,"navigation":909,"surround":1030,"prefix":912},{"id":5,"title":6,"body":7,"description":901,"extension":902,"meta":903,"navigation":904,"path":905,"seo":906,"stem":907,"__hash__":908},"agentDocs\u002Fdocs\u002F4.workflows\u002F4.triggers.md","Triggers",{"type":8,"value":9,"toc":876},"minimark",[10,19,47,52,59,120,128,132,138,160,175,178,183,187,192,217,236,239,246,253,258,310,314,319,355,358,368,373,380,390,396,399,403,408,444,454,461,464,556,560,582,595,599,602,630,633,636,642,645,649,662,666,684,688,699,706,710,717,731,734,738,749,753,760,776,801,806,813,816,820,837,844,849,853,858,861,865],[11,12,13,14,18],"p",{},"The trigger sets what starts a run. Every workflow has exactly one trigger. In the field ",[15,16,17],"strong",{},"Kind"," you choose one of four kinds:",[20,21,22,29,35,41],"ul",{},[23,24,25,28],"li",{},[15,26,27],{},"Form",": a signed-in member starts the run by hand.",[23,30,31,34],{},[15,32,33],{},"Public form",": someone with the link fills in a form and starts a run with it, without signing in.",[23,36,37,40],{},[15,38,39],{},"Schedule",": the workflow runs at fixed times.",[23,42,43,46],{},[15,44,45],{},"Integration",": an event in a connected app starts the run, for example a new email.",[48,49,51],"h2",{"id":50},"configure-the-trigger","Configure the trigger",[11,53,54,55,58],{},"Click the trigger card in the builder. You change the name in the header of the dialog, and below it is the row ",[15,56,57],{},"Note",". The dialog has up to three tiles:",[20,60,61,98,109],{},[23,62,63,66,67,69,70,72,73,75,76,79,80,75,83,86,87,89,90,75,92,94,95,97],{},[15,64,65],{},"Trigger",": always there. Here you choose the ",[15,68,17],{},", and for ",[15,71,45],{}," also ",[15,74,45],{}," and ",[15,77,78],{},"Event",". Below them are ",[15,81,82],{},"Settings",[15,84,85],{},"Start form",", depending on the kind. ",[15,88,82],{}," appears only if the kind has settings. ",[15,91,27],{},[15,93,33],{}," have none. ",[15,96,85],{}," exists only for these two.",[23,99,100,103,104,75,106,108],{},[15,101,102],{},"Responsibility",": only for ",[15,105,45],{},[15,107,33],{},".",[23,110,111,114,115,108],{},[15,112,113],{},"Output",": always there. Shows the fields the trigger puts into the ",[116,117,119],"a",{"href":118},"\u002Fdocs\u002Fworkflows\u002Fsteps","context",[11,121,122,123,75,125,127],{},"You cannot delete or duplicate the trigger. You change its kind instead. This resets the settings. ",[15,124,85],{},[15,126,102],{}," are kept if the new kind has them too.",[48,129,131],{"id":130},"start-by-hand","Start by hand",[11,133,134,135,137],{},"With ",[15,136,27],{},", you fill in a form on start, or just click if there are no fields.",[139,140,141,149,154,157],"ol",{},[23,142,143,144,146,147,108],{},"Set ",[15,145,17],{}," to ",[15,148,27],{},[23,150,151,152,108],{},"Create the questions under ",[15,153,85],{},[23,155,156],{},"Publish the workflow.",[23,158,159],{},"Set the workflow up for yourself.",[11,161,162,163,166,167,170,171,108],{},"After that you start runs in the tab ",[15,164,165],{},"Run"," on the workflow page or with ",[15,168,169],{},"Start now"," on the trigger card. As long as you have no switched-on setup of your own, the start stays locked. How you set a workflow up for yourself is described under ",[116,172,174],{"href":173},"\u002Fdocs\u002Fworkflows\u002Fpublishing","Publishing and setup",[11,176,177],{},"In the start form you set, per question, the label, placeholder, example and order, and whether it is mandatory. Without a list of your own, the form asks for all declared fields in declaration order. The trigger puts only the fields of the start form into the context.",[11,179,180,181,108],{},"With this trigger someone is watching. Agents may therefore ask questions and send messages. The values do not count as content from outside, which is why there is no tile ",[15,182,102],{},[48,184,186],{"id":185},"start-through-a-public-link","Start through a public link",[11,188,189,191],{},[15,190,33],{}," fits when clients or colleagues without access should submit something.",[139,193,194,200,205,207,210],{},[23,195,143,196,146,198,108],{},[15,197,17],{},[15,199,33],{},[23,201,202,203,108],{},"Create the ",[15,204,85],{},[23,206,156],{},[23,208,209],{},"Set the workflow up for yourself and switch it on.",[23,211,212,213,216],{},"On the workflow page, open ",[15,214,215],{},"Form link"," on the trigger card.",[11,218,219,220,223,224,227,228,231,232,235],{},"Your setup must run on a version with this trigger. Under ",[15,221,222],{},"Who may fill in the form?"," you choose ",[15,225,226],{},"Anyone with the link"," or ",[15,229,230],{},"Only members of this workspace",". Switching does not change the address. ",[15,233,234],{},"Revoke link"," makes the link invalid immediately.",[11,237,238],{},"The link belongs to your setup. Every submission starts a run through your accounts and uses credit of the workspace. If your setup is paused, you can still manage the link: change the audience or revoke it. It cannot be reached then.",[11,240,241,242,245],{},"The public page shows the name of the workflow, the fields and ",[15,243,244],{},"Submit",". After that the person sees a confirmation, but no run status, no run number and no result. Any feedback must be sent by the workflow itself, for instance with a step that sends an email. If the link is revoked or the setup is paused, the page shows \"This form does not exist or is no longer shared.\"",[11,247,248,249,252],{},"Everything that comes in through this form is marked ",[15,250,251],{},"External",". This also applies when you enter the values yourself on start. The workflow then treats them like a submission through the link and asks no questions.",[254,255,257],"h3",{"id":256},"limits","Limits",[259,260,261,274],"table",{},[262,263,264],"thead",{},[265,266,267,271],"tr",{},[268,269,270],"th",{},"Limit",[268,272,273],{},"Value",[275,276,277,286,294,302],"tbody",{},[265,278,279,283],{},[280,281,282],"td",{},"Submissions per link and hour",[280,284,285],{},"60",[265,287,288,291],{},[280,289,290],{},"Characters per field value",[280,292,293],{},"10,000",[265,295,296,299],{},[280,297,298],{},"Size of the request",[280,300,301],{},"300,000 bytes",[265,303,304,307],{},[280,305,306],{},"Fields in the form",[280,308,309],{},"24",[48,311,313],{"id":312},"start-on-a-schedule","Start on a schedule",[11,315,316,318],{},[15,317,39],{}," fits daily reports or regular checks, for example. The workflow then runs without a trigger from outside.",[139,320,321,327,335,349],{},[23,322,143,323,146,325,108],{},[15,324,17],{},[15,326,39],{},[23,328,329,330,332,333,108],{},"Under ",[15,331,82],{},", click the field ",[15,334,39],{},[23,336,337,338,341,342,227,345,348],{},"Choose ",[15,339,340],{},"Daily",", ",[15,343,344],{},"On certain weekdays",[15,346,347],{},"Monthly"," and a time.",[23,350,351,352,108],{},"Choose the time zone under ",[15,353,354],{},"Time zone",[11,356,357],{},"Below the field you see the next runs.",[11,359,134,360,363,364,367],{},[15,361,362],{},"Enter cron expression"," you switch to the field ",[15,365,366],{},"Schedule (Cron)",". There you write the schedule as a cron expression, a time specification in text form. This also covers schedules with step values or lists of hours, which the selection cannot represent. If you switch back to the simple selection, such an expression is replaced. The interface warns you about this.",[11,369,370,372],{},[15,371,354],{}," offers Europe\u002FBerlin, Europe\u002FVienna, Europe\u002FZurich, Europe\u002FLondon and UTC. The default is Europe\u002FBerlin. Daylight saving time is taken into account.",[11,374,375,376,379],{},"Each person can set a time of their own during ",[116,377,378],{"href":173},"setup",". The time zone for it comes from their browser and cannot be chosen.",[11,381,382,383,385,386,389],{},"Only ",[15,384,39],{}," has ",[15,387,388],{},"Run once now",". It immediately starts a run through your setup. The schedule continues independently of it.",[11,391,392,393,395],{},"The trigger puts no field into the context, not even the scheduled time. The first step fetches all data itself. There is no tile ",[15,394,102],{},", because a schedule delivers no content from outside.",[11,397,398],{},"Missed times are not made up. If the server restarts in the minute that is due, the run drops out without replacement.",[48,400,402],{"id":401},"start-on-an-app-event","Start on an app event",[11,404,405,407],{},[15,406,45],{}," fits when the workflow should react to something that happens in another system.",[139,409,410,416,421,426],{},[23,411,143,412,146,414,108],{},[15,413,17],{},[15,415,45],{},[23,417,418,419,108],{},"Choose the app under ",[15,420,45],{},[23,422,423,424,108],{},"Choose the event under ",[15,425,78],{},[23,427,428,429,431,432,341,435,341,438,227,441,108],{},"Narrow down the source under ",[15,430,82],{},", depending on the event for example with ",[15,433,434],{},"Folder",[15,436,437],{},"Channel",[15,439,440],{},"Table",[15,442,443],{},"Repository",[11,445,446,447,450,451,453],{},"For ",[15,448,449],{},"IMAP mailbox",", the ",[15,452,434],{}," is INBOX by default, the inbox. For Microsoft Teams, the selection lists show the teams, channels and chats of your connected account.",[11,455,456,457,108],{},"The trigger names no account. Each person chooses during setup which mailbox or calendar is queried. How you connect an account is described under ",[116,458,460],{"href":459},"\u002Fdocs\u002Fconnections\u002Fservices","Connecting services",[11,462,463],{},"There are more than 25 events:",[259,465,466,476],{},[262,467,468],{},[265,469,470,473],{},[268,471,472],{},"App",[268,474,475],{},"Events",[275,477,478,486,494,500,508,516,524,532,540,548],{},[265,479,480,483],{},[280,481,482],{},"Outlook Mail",[280,484,485],{},"New email",[265,487,488,491],{},[280,489,490],{},"Gmail",[280,492,493],{},"New email, Label changed",[265,495,496,498],{},[280,497,449],{},[280,499,485],{},[265,501,502,505],{},[280,503,504],{},"Google Calendar",[280,506,507],{},"New event, Event starts",[265,509,510,513],{},[280,511,512],{},"Microsoft Teams",[280,514,515],{},"New chat message, New channel message, New mention in channel, New meeting transcript",[265,517,518,521],{},[280,519,520],{},"Stripe",[280,522,523],{},"Payment received, Payment failed, New invoice, New subscription, Subscription cancelled",[265,525,526,529],{},[280,527,528],{},"Pipedrive",[280,530,531],{},"New deal, Deal won, New contact, New lead",[265,533,534,537],{},[280,535,536],{},"Airtable",[280,538,539],{},"New record, Changed record",[265,541,542,545],{},[280,543,544],{},"Shopify",[280,546,547],{},"New order, Order paid",[265,549,550,553],{},[280,551,552],{},"GitHub",[280,554,555],{},"New issue, New comment, New pull request, Pull request merged, New commit, New release",[254,557,559],{"id":558},"event-fields","Event fields",[11,561,562,563,565,566,341,569,341,572,75,575,578,579,581],{},"Every event puts its fields into the context. For ",[15,564,485],{}," in Outlook Mail these are ",[15,567,568],{},"Sender",[15,570,571],{},"Subject",[15,573,574],{},"Content",[15,576,577],{},"Received on",". These four fields are marked ",[15,580,251],{},". Their content comes from outside, and the agent is instructed not to follow instructions in it.",[11,583,584,585,588,589,591,592,108],{},"The ",[15,586,587],{},"Message ID"," is an identifier that only the trigger can write. It is not marked ",[15,590,251],{},". It reaches only steps that explicitly request it, for instance a tool for replying, forwarding or attachments. Under the same rule, Gmail also delivers the ",[15,593,594],{},"Conversation ID",[254,596,598],{"id":597},"polling","Polling",[11,600,601],{},"lowcloud regularly asks for new events for every switched-on setup. Push notifications from the providers do not exist.",[259,603,604,612],{},[262,605,606],{},[265,607,608,610],{},[268,609,270],{},[268,611,273],{},[275,613,614,622],{},[265,615,616,619],{},[280,617,618],{},"Interval between two checks",[280,620,621],{},"60 seconds, cannot be configured",[265,623,624,627],{},[280,625,626],{},"Events per trigger and check",[280,628,629],{},"15",[11,631,632],{},"Each setup keeps its own record of the events it has already seen. Two people can therefore watch the same mailbox without taking events away from each other.",[11,634,635],{},"A newly set up or changed trigger begins at the current time. It never catches up on older emails, calendar events or records. About two minutes can pass before the first run.",[637,638,639],"warning",{},[11,640,641],{},"After a change the trigger starts over. Whatever arrives during the change is not processed.",[11,643,644],{},"Gmail can discard its change feed after about a week. The trigger then starts again and reports that events from the gap are missing.",[254,646,648],{"id":647},"pre-filters-at-the-provider","Pre-filters at the provider",[11,650,651,654,655,658,659,661],{},[15,652,653],{},"Gmail search"," for Gmail and ",[15,656,657],{},"Search term"," for Google Calendar filter at the provider. Whatever they sort out appears in no run. To filter by content, use ",[15,660,102],{}," instead. There every run states why something was rejected.",[254,663,665],{"id":664},"app-specific-behavior","App-specific behavior",[20,667,668,671,677],{},[23,669,670],{},"A shared Outlook mailbox needs additional permissions. A connection granted earlier has to be reconnected once for that.",[23,672,673,676],{},[15,674,675],{},"New chat message"," in Teams, without a selected chat, sees only the latest message of each chat per check.",[23,678,679,680,683],{},"Airtable without a ",[15,681,682],{},"Title column"," set takes the first filled column. That can be the wrong one.",[48,685,687],{"id":686},"set-the-responsibility","Set the responsibility",[11,689,690,691,693,694,75,696,698],{},"In ",[15,692,102],{}," you describe in your own words which incoming items the workflow should handle. For example: \"only support requests from existing customers, no newsletters\". The field exists only for ",[15,695,45],{},[15,697,33],{},", the kinds with content from outside.",[11,700,701,702,705],{},"Every incoming event is checked against this text. Whatever does not fit ends as ",[15,703,704],{},"Skipped",". If the field stays empty, every event of the source starts a complete run.",[254,707,709],{"id":708},"how-the-check-runs","How the check runs",[11,711,712,713,716],{},"From the text, lowcloud builds the first step of every run, ",[15,714,715],{},"Check responsibility",". You do not build a card for it. A model checks the event without tools and answers yes or no with a reason.",[11,718,719,720,722,723,726,727,730],{},"On no, the run ends with the status ",[15,721,704],{}," and the model's reason. None of the steps you built runs then. Skipped runs are hidden by default in the section ",[15,724,725],{},"Runs"," of the workflow overview and do not count towards the success rate. ",[15,728,729],{},"Show N skipped"," shows them.",[11,732,733],{},"The check is one model call per incoming event. It costs even when the event is skipped afterwards.",[254,735,737],{"id":736},"model-for-the-check","Model for the check",[11,739,740,741,744,745,748],{},"As soon as there is text in the field, ",[15,742,743],{},"Model"," appears below it. There you choose the model for the check from the list. The top row stands for no model of its own. It is called ",[15,746,747],{},"Automatic",", even when the workspace has set a default model. An unknown model is rejected as an error on publishing.",[48,750,752],{"id":751},"test-with-a-real-event","Test with a real event",[11,754,755,756,759],{},"Below the trigger card in the builder is the panel ",[15,757,758],{},"Test run",". With it you start a run without waiting for a new event.",[139,761,762,768,771],{},[23,763,764,765,108],{},"Click ",[15,766,767],{},"Load latest events",[23,769,770],{},"Select an event from the list.",[23,772,764,773,108],{},[15,774,775],{},"Test with this event",[11,777,778,779,781,782,784,785,788,789,75,791,793,794,797,798,108],{},"You can load real events only for ",[15,780,45],{},". For ",[15,783,39],{}," the button is called ",[15,786,787],{},"Simulate tick",", for ",[15,790,27],{},[15,792,33],{}," it is called ",[15,795,796],{},"Start test run",". Via the additional menu you run ",[15,799,800],{},"Trigger only",[637,802,803],{},[11,804,805],{},"A test run behaves like live operation. Tools without approval send real emails and write real data.",[11,807,808,809,812],{},"The test run works against the draft, not against the published version. It reads the events from your own connected account, not from the account of a setup. Without a connected account for the service, you cannot select events. Connect one under ",[15,810,811],{},"Connections"," in that case.",[11,814,815],{},"A test run does not take an event away from live operation. It does not change which events the trigger has already seen.",[48,817,819],{"id":818},"trigger-errors","Trigger errors",[11,821,822,823,826,827,830,831,826,834,108],{},"The trigger dialog shows when the trigger last fired. It shows an error as a red box ",[15,824,825],{},"Last error"," with ",[15,828,829],{},"Open connections",". On the workflow overview, the same error appears under ",[15,832,833],{},"Check trigger",[15,835,836],{},"Open in builder",[11,838,839,840,843],{},"If your setup has no account for the trigger, the trigger pauses. Your row then shows ",[15,841,842],{},"Paused"," and the note that no account of yours is assigned to the trigger.",[11,845,846,847,108],{},"A workflow that nobody has set up for themselves does not run, whatever the trigger. How you set up a workflow is described under ",[116,848,174],{"href":173},[48,850,852],{"id":851},"webhooks","Webhooks",[11,854,855,856,108],{},"There is no webhook trigger, so another system cannot start a workflow. It is not available in the field ",[15,857,17],{},[11,859,860],{},"The chat in the builder can still write a webhook trigger into the draft. The draft can then be saved but not published. The message says: \"Webhook triggers are currently not available. The workflow cannot be published.\" The address of an old webhook always answers with \"Webhook triggers are currently not available.\"",[48,862,864],{"id":863},"permissions","Permissions",[11,866,867,868,871,872,875],{},"Anyone who may build (the role ",[15,869,870],{},"admin",", or the former role ",[15,873,874],{},"developer",") can create the link to a public form. Nobody else can. The same applies to a test run with a real event.",{"title":877,"searchDepth":878,"depth":878,"links":879},"",2,[880,881,882,886,887,893,897,898,899,900],{"id":50,"depth":878,"text":51},{"id":130,"depth":878,"text":131},{"id":185,"depth":878,"text":186,"children":883},[884],{"id":256,"depth":885,"text":257},3,{"id":312,"depth":878,"text":313},{"id":401,"depth":878,"text":402,"children":888},[889,890,891,892],{"id":558,"depth":885,"text":559},{"id":597,"depth":885,"text":598},{"id":647,"depth":885,"text":648},{"id":664,"depth":885,"text":665},{"id":686,"depth":878,"text":687,"children":894},[895,896],{"id":708,"depth":885,"text":709},{"id":736,"depth":885,"text":737},{"id":751,"depth":878,"text":752},{"id":818,"depth":878,"text":819},{"id":851,"depth":878,"text":852},{"id":863,"depth":878,"text":864},"Start workflows by hand, through a link, on a schedule or on an event in an app.","md",{},true,"\u002Fdocs\u002Fworkflows\u002Ftriggers",{"title":6,"description":901},"docs\u002F4.workflows\u002F4.triggers","5GmVnD5g-yDqxGzQ2uH_bnaUbYeVkYvz4dprBtGl_wo",[910],{"title":911,"path":912,"stem":913,"children":914,"page":-1},"Docs","\u002Fdocs","docs",[915,918,937,942,967,990,995,1007,1012],{"title":916,"path":912,"stem":917},"Documentation","docs\u002Findex",{"title":919,"icon":920,"path":921,"stem":922,"children":923,"page":936},"Getting started","i-lucide-compass","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[924,928,932],{"title":925,"path":926,"stem":927},"Overview","\u002Fdocs\u002Fgetting-started\u002Foverview","docs\u002F1.getting-started\u002F1.overview",{"title":929,"path":930,"stem":931},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F2.quickstart",{"title":933,"path":934,"stem":935},"Glossary","\u002Fdocs\u002Fgetting-started\u002Fglossary","docs\u002F1.getting-started\u002F3.glossary",false,{"title":938,"path":939,"stem":940,"icon":941},"Chat","\u002Fdocs\u002Fchat","docs\u002F2.chat","i-lucide-message-circle",{"title":943,"icon":944,"path":945,"stem":946,"children":947,"page":936},"Agents","i-lucide-bot","\u002Fdocs\u002Fagents","docs\u002F3.agents",[948,952,956,960,964],{"title":949,"path":950,"stem":951},"Building agents","\u002Fdocs\u002Fagents\u002Fbuilding","docs\u002F3.agents\u002F1.building",{"title":953,"path":954,"stem":955},"Knowledge","\u002Fdocs\u002Fagents\u002Fknowledge","docs\u002F3.agents\u002F2.knowledge",{"title":957,"path":958,"stem":959},"Skills","\u002Fdocs\u002Fagents\u002Fskills","docs\u002F3.agents\u002F3.skills",{"title":961,"path":962,"stem":963},"Sharing and access","\u002Fdocs\u002Fagents\u002Fsharing","docs\u002F3.agents\u002F4.sharing",{"title":512,"path":965,"stem":966},"\u002Fdocs\u002Fagents\u002Fteams","docs\u002F3.agents\u002F5.teams",{"title":968,"icon":969,"path":970,"stem":971,"children":972,"page":936},"Workflows","i-lucide-workflow","\u002Fdocs\u002Fworkflows","docs\u002F4.workflows",[973,977,981,984,985,987],{"title":974,"path":975,"stem":976},"Your first workflow","\u002Fdocs\u002Fworkflows\u002Ffirst-workflow","docs\u002F4.workflows\u002F1.first-workflow",{"title":978,"path":979,"stem":980},"The builder","\u002Fdocs\u002Fworkflows\u002Fbuilder","docs\u002F4.workflows\u002F2.builder",{"title":982,"path":118,"stem":983},"Steps","docs\u002F4.workflows\u002F3.steps",{"title":6,"path":905,"stem":907},{"title":174,"path":173,"stem":986},"docs\u002F4.workflows\u002F5.publishing",{"title":725,"path":988,"stem":989},"\u002Fdocs\u002Fworkflows\u002Fruns","docs\u002F4.workflows\u002F6.runs",{"title":991,"path":992,"stem":993,"icon":994},"Approvals","\u002Fdocs\u002Fapprovals","docs\u002F5.approvals","i-lucide-check-check",{"title":996,"icon":997,"path":998,"stem":999,"children":1000,"page":936},"Integrations","i-lucide-cable","\u002Fdocs\u002Fconnections","docs\u002F6.connections",[1001,1003],{"title":460,"path":459,"stem":1002},"docs\u002F6.connections\u002F1.services",{"title":1004,"path":1005,"stem":1006},"Custom integrations and MCP","\u002Fdocs\u002Fconnections\u002Fcustom","docs\u002F6.connections\u002F2.custom",{"title":1008,"path":1009,"stem":1010,"icon":1011},"Sovereignty","\u002Fdocs\u002Fsovereignty","docs\u002F7.sovereignty","i-lucide-shield-check",{"title":1013,"icon":1014,"path":1015,"stem":1016,"children":1017,"page":936},"Workspace","i-lucide-users","\u002Fdocs\u002Fworkspace","docs\u002F8.workspace",[1018,1022,1026],{"title":1019,"path":1020,"stem":1021},"Workspace and roles","\u002Fdocs\u002Fworkspace\u002Froles","docs\u002F8.workspace\u002F1.roles",{"title":1023,"path":1024,"stem":1025},"Credit and costs","\u002Fdocs\u002Fworkspace\u002Fcosts","docs\u002F8.workspace\u002F2.costs",{"title":1027,"path":1028,"stem":1029},"Partner","\u002Fdocs\u002Fworkspace\u002Fpartner","docs\u002F8.workspace\u002F3.partner",[1031,1033],{"title":982,"path":118,"stem":983,"description":1032,"children":-1},"Set up agents, actions and conditions and pass results on through the context.",{"title":174,"path":173,"stem":986,"description":1034,"children":-1},"Publish a workflow as a version and set it up for yourself.",1791184597786]