Skip to main content
All CollectionsBuild AutomationsTriggers
Initiating Workflow Executions: Workflow Triggers in Torq
Initiating Workflow Executions: Workflow Triggers in Torq

Learn about Torq's workflow triggers and how to use them efficiently.

Updated over a week ago

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.

Select a trigger when creating a workflow

Triggers Overview

  • 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.

  • Schedule trigger: Schedule workflows to run at specific times, such as weekly or daily intervals.

    • Workflow failure: Receive an event for every workflow execution failure or incomplete run.

    • Step failure: Receive an event for every unsuccessful step execution.

    • Request for review: Receive an event when a workflow is submitted for review.

    • Share request created: Receive an event when a request to share a resource with the workspace is created.

  • Torq Cases: Trigger workflows with case management related events.

  • Torq Interact: Trigger workflows using Torq's customizable web pages and forms.

Replace a Trigger

  1. Open the workflow and select the trigger.

  2. Click the Replace icon above the trigger.

  3. Choose the new trigger, specifying the integration type and instance for integration triggers.

Replace a trigger

Set Trigger Conditions

Add trigger conditions to determine which events will start workflow executions. More information about conditions is available here.

  1. Open the workflow and click the trigger.

  2. Click Add Condition to define trigger conditions. The event JSON is accessible by using: {{ $.event.<trigger event structure> }}

  3. Optionally, add multiple conditions using OR and AND logic.

  4. Optionally, go to the Event Log tab to see which past events meet the trigger conditions. The events with the green checkmark meet the current trigger conditions, meaning they can trigger the workflow.

Set trigger conditions

View Event History

  1. Open the workflow and click the trigger.

  2. Navigate to the Event Log tab to view past trigger events.

  3. Events meeting current trigger conditions are marked with a green checkmark.

View past trigger events

Resend Events

You can resend any past event, either to test the current workflow functionality or to rerun a production event.

  1. Open the workflow and click the trigger.

  2. Select the Event Log tab. The events with the green checkmark meet the current trigger conditions, meaning they can trigger the workflow.

  3. Select the event to resend and click the Resend icon, or click Test Run and select the event from the list.

  4. Optionally, modify the event JSON before resending.

Resend an event
Did this answer your question?