Trigger types
A trigger is the event that starts a flow. Every flow begins with a When row in the flow composer, and the trigger you pick there decides which filters and actions are available. This page lists the triggers you can choose and explains where to browse them.
Triggers you can pick in the flow composer
Open Automation → Flows, create or edit a flow, and open the When menu. Triggers are grouped as follows.
Group | Trigger | Starts the flow when |
|---|---|---|
Workflow events | Task enters a workflow state | A task is created in, or moved into, the state you choose |
Workflow events | Interactive run is approved | Someone approves an interactive agent run on a task that is in the state you choose |
GitHub events | GitHub push arrives, pull request opens, merges, closes without merging, review is requested, release publishes, check suite completes | Your connected GitHub repositories send that event |
GitLab events | GitLab push arrives, merge request opens, merges, closes without merging, release publishes, pipeline completes | Your connected GitLab projects send that event |
Advanced | Schedule ticks | The schedule you set is due |
For details and setup steps, see:
How the trigger affects the action
Workflow triggers let you choose any of the three flow actions: Start an agent run, Move the task to a state, or Merge into. GitHub, GitLab, and schedule triggers can only Start an agent run. See Choose a flow action.
Event triggers can also include an optional semantic condition, a plain-language check that must clearly match before the action runs. You can't add a semantic condition to a scheduled flow.
Browse the trigger catalog
Workspace administrators can open Automation → Triggers to see every event the workspace can react to. The catalog has three tabs:
Flow – event and schedule triggers used by flows.
Manual – agent runs that people start from tasks, epics, documents, repositories, the support inbox, or the Agents page.
Built-in – product-owned triggers that you configure in feature settings, such as AI replies to new messages in the support widget.
Each row shows the trigger's source and how often it's used. Where available, use Create flow to start a flow with that trigger, View flows to see the flows that use it, or View history to see recent trigger activity.
Related
Was this article helpful?