Triggers

a trigger starts a playbook run a playbook can define more than one trigger; each flow uses one trigger at a time add most triggers from the playbook canvas add panel, then drag the trigger onto the canvas turbine has the following trigger types trigger type typical use using webhook triggers in swimlane turbine https //docs swimlane com/using webhook triggers in swimlane turbine external systems post or get to a turbine url to start or supply payload data record event triggers https //docs swimlane com/record event triggers create, update, or delete on selected applications or records schedule triggers https //docs swimlane com/schedule triggers time based or cron style runs playbook button triggers https //docs swimlane com/playbook button triggers users start a run from the canvas or from an application flow event trigger https //docs swimlane com/flow event trigger another flow or playbook activity drives execution (orchestration between flows) datetime field trigger /#datetime field trigger runs a flow when a record date/time field value (± offset) is reached added from application builder field settings, not from the canvas add panel the playbook button triggers https //docs swimlane com/playbook button triggers type is also available via applications continue to the following sections for details and configuration of each type of trigger for datetime field triggers, start in application builder — see select fields and assign field properties select%20fields%20and%20assign%20field%20properties md #datetime field triggers datetime field trigger starting in turbine 26 3 0 , a datetime field trigger starts a playbook flow when a record's date/time field reaches the configured fire time (field value plus optional offset) how you add it configure trigger playbook on a date/time field in application builder ( advanced → configure ) saving the application adds the datetime field trigger to the selected flow automatically the datetime field trigger is not listed in the canvas add panel you cannot create one by dragging a trigger onto the canvas how it appears on the canvas when a flow has a datetime field trigger, the trigger details panel shows read only values field description application application that owns the date/time field date/time field field that drives the schedule offset configured offset and unit relative to the field value notice tip in the ui configured via the application's field settings playbook run history currently labels these runs as delay trigger (canvas label is datetime field trigger ) record data passed to the playbook when a datetime field trigger fires, the playbook receives the full record for that application—field schema and values—not only the tracking id downstream actions can map record fields from the datetime field trigger output the same way they do for a record event trigger you do not need a separate lookup that starts from tracking id alone to read other field values the tracking id remains available as part of the record data scheduling behavior record create with a date/time value schedules a run record update that changes the date/time value reschedules the pending run clearing the date/time value or deleting the record cancels the pending run deleting the field, clearing the field configuration, or deleting the linked playbook or flow removes or clears the datetime field trigger and cancels outstanding schedules solution builder warns when delete or disable actions would clear datetime field trigger configuration from linked applications flow sharing rules starting in turbine 26 3 3 , application builder save validation uses these rules assignment can share one flow? two or more playbook buttons yes a playbook button and correlation yes a datetime field trigger and a playbook button, correlation, or another datetime field trigger no assign the datetime field trigger to a flow that no other trigger uses if you save an application and see duplicate flow assignments across triggers , the datetime field trigger is sharing a flow point the datetime field trigger at an unused flow, then save again limits and scope (phase 1) offset units minutes or hours maximum absolute offset 7 days phase 1 covers time based field triggering only dedicated sla field types are planned for later releases see also select fields and assign field properties select%20fields%20and%20assign%20field%20properties md #datetime field triggers — configure offset, playbook, and flow configuring playbooks configuring%20playbooks md — playbook configuration overview application builder application%20builder md — save validation for shared flows schedule triggers https //docs swimlane com/schedule triggers — recurring or cron schedules (different from datetime field trigger)