Skip to content

Create a workflow

A workflow is a reusable approval route: define it once, and every request of that kind follows it. Creating one sets up the record and its first draft; nothing routes through it until you design, publish, and bind it.

Required role: Administrator.

  1. Go to Approvals → Workflows.
  2. Select New Workflow.
  3. Enter the Name. Name it after the request it handles, not after the department that owns it.
  4. Leave Code blank unless you have a naming standard of your own. A code is generated if you do not supply one.
  5. Write a Description that says what the workflow decides.
  6. Set a Category so the list stays navigable as the number of workflows grows.
  7. Add the Trigger Resource Types this workflow is meant for, pressing Enter or comma after each.
  8. Select Create workflow.
The New workflow form filled in with the name Travel Expense Approval, a description of what it decides, the Finance category, and expense_claim added as a trigger resource type.

You land in the designer on a new, empty draft version. Nothing has been published, and no request can reach the workflow yet.

OptionDescription
NameWhat the workflow is called everywhere it appears — in the list, on a task in an approver’s inbox, and in analytics.
CodeA short identifier, for example WF-PROMOTION-APPROVAL. Optional; one is generated if you leave it blank.
DescriptionWhat this workflow decides. Worth writing, because whoever inherits it will read this first.
CategoryA grouping of your own choosing, such as HR, Compliance, or Finance. It filters the list.
Trigger Resource TypesThe kinds of request this workflow is intended to handle.
TemplateMarks the workflow as a reusable starting point rather than a route you intend to run.
Template CategoryThe group a template appears under. Available once Template is on.

Example: HC Corp creates Promotion Approval, categorised under HR, for promotion requests. The name is what Olivia Bennett will see at the top of the task when she is asked to decide one.

Advanced holds two optional fields describing the data a request carries: a context schema and a sample context. The sample is the data your simulations run against, so filling it in is what makes testing the route against realistic values possible later.

Leave both empty if you are not sure. Neither is needed to build or publish a route.

The Templates tab on the workflows list holds workflows marked as templates, grouped by category. Use Template creates a workflow from one, which you then edit as your own.

A template is a starting shape, not a policy. Read every step before publishing — the approvers and deadlines in a template are examples, not your organization’s.

The workflows list shows each workflow’s name, code, status, category, owner, and current version. Status is the thing to watch:

OptionDescription
DraftBeing built. Nothing routes through it.
ActiveIn service. Requests can be routed to it where a binding says so.
ArchivedRetired. Kept for the history of what it decided.

Row actions cover the rest of the lifecycle:

OptionDescription
ActivatePuts a draft into service. Available only once a version has been published — a draft with no published version cannot be activated.
ArchiveRetires the workflow.
DuplicateCreates a draft copy under a new name. This is how you experiment without touching something live.
DeleteRemoves the workflow from the list.

The workflow exists as a draft with an empty first version. Design the route on the canvas, validate it, and publish that version — publishing is what makes activation possible, and a binding is what decides which real requests reach it.