Workflow triggers: what can start a workflow

Every event that can start a workflow, and the settings that narrow down when it runs.

4 min readUpdated 5 days ago
Before you start. Owners, Admins and Members can add and change triggers, on every plan.
The trigger is the first node of a workflow: the event it waits for. In the workflow builder, open Triggers under Nodes to see them in groups, then drag one onto the canvas.
The trigger groups under Nodes.
The trigger groups under Nodes.
Select the trigger on the canvas to see its settings on the right. Most triggers can be narrowed down, for example to one board or one type of feedback. Leave a setting on Any to run for all of them.
A trigger's settings: Board and Vote Threshold for Post Reaches Votes.
A trigger's settings: Board and Vote Threshold for Post Reaches Votes.
Feedback
TriggerRuns whenSettings
Feedback CreatedSomeone sends feedback.Feedback Type: Bug, Idea, General or Testimonial
Feedback Status ChangedA report's status changes.From Status and To Status: Open, In Progress, Under Review or Resolved
Feedback ResolvedA report is marked Resolved.Feedback Type
Feedback AssignedA report is assigned to a teammate.None
Help Article RatedA reader answers "Was this helpful?" on a help article.Rating: Helpful only or Not helpful only
Changes that a workflow makes itself, such as Update Feedback Status, don't start these triggers. That keeps one workflow from setting off another in a loop.
Portal
TriggerRuns whenSettings
Post CreatedA new post is added to a board.Board
Post Status ChangedA post moves from one status to another.Board, From Status, To Status
Post Reaches VotesA post reaches the number of votes you set.Board, Vote Threshold
Post CommentedSomeone comments on a post.Board, Comment Author: Anyone, Portal visitors or Your team
Post Waiting for ReviewA submitted post is held for review.Board
Post ApprovedA held post is approved.Board
Post DeclinedA held post is declined.Board
Post MergedA post is merged into another as a duplicate.Board
Post TaggedA tag is added to a post.Board, Tag
Post Status Changed needs a board. The two status lists open once you pick one.
Post Reaches Votes runs once per post, on the vote that reaches your number. Set Vote Threshold to 0 to run on every vote.
If your workflow comments on posts, keep Post Commented on Portal visitors. Your workflow's own comment then won't start it again.
Changelog
TriggerRuns when
Changelog PublishedA changelog entry goes live, including a scheduled entry when its time comes.
Changelog Subscriber AddedSomeone subscribes to your changelog.
Inbox
TriggerRuns when
Inbox Message ReceivedA new message arrives in a support conversation with your team. Your team's replies count too.
Inbox MentionedA teammate is mentioned in a support conversation.
Keep Inbox Type on Any for both.
Code Scan, Monitoring and Contacts
TriggerRuns whenSettings
Code Scan Issue DetectedA finished code scan finds bugs or vulnerabilities.Keep Severity and Issue Type on Any
Monitor DownA monitor goes down.Monitor: Any monitor or one monitor
Monitor UpA monitor recovers.Monitor
Incident CreatedA new incident is opened.Severity: Low, Medium, High or Critical
Incident ResolvedAn incident is resolved.Severity
Contact Enters a SegmentA contact starts matching a segment.Segment: Any segment or one segment
Contact Leaves a SegmentA contact stops matching a segment.Segment
Rules for every trigger
•
A workflow has one trigger. To react to two events, build two workflows.
•
Each project can have one workflow per trigger and settings. A second Feedback Created workflow for bugs is refused, but one for ideas is fine.
•
Only workflows that are switched on run. A paused workflow ignores its trigger.
•
Every step after the trigger can use the trigger's details, such as the report's title. Add AI steps and use data from earlier steps shows how.
Next, see what a workflow can do in Workflow actions.

Was this helpful?

Your feedback shapes what we write next.

Related articles