<!-- Source: https://docs.vinsi.ai/tickets/workflow -->
# Workflow

Automate ticket routing, escalation, and resolution with configurable workflows.

Created March 27, 2026

## Overview

Workflows automate repetitive ticket handling by listening for a trigger, checking ticket details, and then running one or more actions. They help teams route new requests, escalate urgent work, update ticket fields, notify the right people, and add internal notes without manual follow-up.

A workflow is built from connected nodes. Every workflow starts with a **Trigger**, can branch through **Conditions**, runs **Actions**, and finishes with an **End** node. You can create broad workflows that apply to all tickets or limit a workflow to a specific catalog item.

Common examples include assigning all IT tickets to the IT support group, raising high-priority tickets to urgent status, emailing a requester when a ticket is updated, or adding an internal note when a ticket reaches a specific status.

## Creating a Workflow ![new-workflow-button](https://docs.vinsi.ai/images/tickets/symbols/workflow/new-workflow.svg)

![new-workflow-png](https://docs.vinsi.ai/images/tickets/vinsi-screenshots/new-workflow.png)

In this menu you can create a workflow which will allow you to automate what happens to a ticket based on what happens with a ticket (**trigger**). Connect **nodes** in the workflow screen to create an automated action.

1. Select **New Workflow** from the Workflow page.
2. Enter a descriptive **Workflow Name** so admins can understand what the automation does at a glance.
3. Choose the **Trigger** that should start the workflow, such as Ticket Created, Ticket Updated, Status Changed, or Ticket Assigned.
4. Use **Catalog Item** when the automation should only run for one request type, or leave it set to all tickets when the rule should apply broadly.
5. Add a short **Description** that explains the purpose of the workflow.
6. Create the workflow, then connect trigger, condition, action, and ending nodes in the workflow builder.

## Nodes

### Triggers

Trigger nodes define the event that starts the workflow — every workflow must begin with a trigger that detects a change or action on a ticket.

#### ![ticket-created](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-ticket-created.svg)Ticket Created

Fires when a new ticket is submitted to the system.

#### ![ticket-updated](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-ticket-updated.svg)Ticket Updated

Fires whenever any field on an existing ticket is modified.

#### ![status-changed](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-status-changed.svg)Status Changed

Fires when a ticket's status transitions from one state to another.

#### ![ticket-assigned](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-ticket-assigned.svg)Ticket Assigned

Fires when a ticket is assigned to a team member.

### Conditions

Condition nodes evaluate ticket data and branch the workflow down different paths depending on whether the specified criteria are met.

#### ![check-field](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-check-field.svg)Check Field

Branches the workflow based on the value of a specific ticket field.

#### ![check-priority](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-check-priority.svg)Check Priority

Branches the workflow based on the ticket's priority level.

#### ![check-status](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-check-status.svg)Check Status

Branches the workflow based on the ticket's current status.

#### ![check-catalog](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-check-catalog.svg)Check Catalog Item

Branches the workflow based on the catalog item type associated with the ticket.

#### ![check-custom-field](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-check-custom-field.svg)Check Custom Field

Branches the workflow based on the value of a custom field defined in the catalog.

### Actions

Action nodes perform an operation on the ticket — such as assigning it, updating its fields, or sending a notification — when the workflow reaches that step.

#### ![assign-agent](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-assign-agent.svg)Assign Agent

Automatically assigns the ticket to a specific agent.

#### ![assign-group](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-assign-group.svg)Assign Group

Automatically assigns the ticket to a team or support group.

#### ![set-status](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-set-status.svg)Set Status

Changes the ticket's status to a specified value.

#### ![set-priority](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-set-priority.svg)Set Priority

Updates the ticket's priority level automatically.

#### ![set-department](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-set-department.svg)Set Department

Assigns the ticket to a specific department.

#### ![send-email](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-send-email.svg)Send Email

Sends an automated email notification to a specified recipient.

#### ![add-note](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-add-note.svg)Add Note

Automatically adds a note to the ticket as part of the workflow.

### Endings

Ending nodes mark the conclusion of a workflow path, signaling that all actions for that branch have been executed and the workflow is complete.

#### ![end](https://docs.vinsi.ai/images/tickets/symbols/workflow/workflow-end.svg)End

Terminates the workflow once all preceding actions have been completed.
