Skip to main content

Overview

Case triggers start a workflow when selected case events happen. Case trigger

Trigger payload

Case trigger data is available under ${{ TRIGGER }}. Fields:
  • ${{ TRIGGER.case_id }}: case ID.
  • ${{ TRIGGER.event }}: event details.
  • ${{ TRIGGER.tags }}: case tags.
  • ${{ TRIGGER.workspace_id }}: workspace ID.
Example payload:

Case events

One or more case events must be selected before the trigger is enabled. Supported event families include:
  • Case events such as create, update, close, reopen, and view.
  • Comment events such as comment and reply activity.
  • Field changes such as status, priority, severity, assignee, and payload changes.
  • Tag events such as tag add and remove.
  • Task events such as task create, delete, and workflow or assignee changes.
  • Attachment events such as add and remove.
  • Dropdown changes.

Tag allowlist

Restrict runs to matching tags. If the allowlist is empty, no tag filtering is applied. Tag add and remove events match the tag that was added or removed. All other events match the tags the case has when Tracecat starts the run. Tracecat saves the tags you pass when creating a case together with the case, so case_created matches them unless the case’s tags change before the run starts. Tags you add after creating the case fire tag_added. To filter case_created on a tag, set the tag in the create call.

Important behavior

Workflow-originated case events are ignored to avoid loops.