Every workflow begins with a trigger, defining the event that initiates the workflow execution. A trigger event consists of structured data in JSON format, which can be accessed in the workflow steps.
Trigger options include workflows started by users, events from other services, case management scenarios, and more.
Trigger types
Choose a trigger type to define how a workflow starts and what event context it receives.
On-demand trigger: Start a user-initiated workflow execution from Torq or other platforms, allowing customization of the trigger event.
Integration trigger: Ingest events from third-party services to Torq via webhooks.
Generic webhook: Generate webhooks to accept events from any third-party service, with the option to accept raw HTTP requests.
Schedule trigger: Schedule workflows to run at specific times, such as weekly or daily intervals.
System events: Trigger workflows automatically based on platform-generated events, such as workflow or step failures, review requests, resource-sharing actions, and more.
Torq Cases: Trigger workflows with case management-related events.
Torq Interact: Trigger workflows using Torq's customizable web pages and forms.
Replace a trigger
You can replace an existing trigger with a different trigger type if your automation requirements change, without rebuilding the entire workflow.
Open the workflow and select the trigger: Click the trigger you want to replace on the workflow canvas.
Replace the trigger: Click the Replace icon above the trigger.
Choose a new trigger: Select the new trigger and, if applicable, specify the integration type and integration instance.
Set trigger conditions
Add trigger conditions to determine which events will start workflow executions. More information about conditions is available here.
Open the workflow and select the trigger: Click the trigger on the workflow canvas.
Add trigger conditions: Click Add Condition to define trigger conditions. You can reference the event JSON using
{{ $.event.<trigger event structure> }}.(Optional) Add multiple conditions: Combine conditions using AND / OR logic as needed.
(Optional) Validate conditions: Open the Event Log tab to see which past events meet the current trigger conditions. Events marked with a green checkmark can trigger the workflow.
It is good practice to review trigger conditions to ensure they are well-defined and supported, and check for any conflicting conditions or missing parameters.
View event history
You can view past trigger events to monitor activity, troubleshoot issues, or verify that events were received and processed correctly.
Open the workflow and select the trigger: Click the trigger on the workflow canvas.
View past events: Navigate to the Event Log tab to see previous trigger events.
Identify matching events: Events that meet the current trigger conditions are marked with a green checkmark.
Trigger events are retained for 90 days, with a maximum of 30 events available at a time.
Resend events
You can resend any past event, either to test the current workflow functionality or to rerun a production event.
Open the workflow and select the trigger: Click the trigger on the workflow canvas.
Review eligible events: Select the Event Log tab. Events marked with a green checkmark meet the current trigger conditions and can trigger the workflow.
Resend an event: Select the event and click the Resend icon, or click Test Run and choose the event from the list.
(Optional) Modify the event: Update the event JSON before resending, if needed.
