Small BusinessReal EstateFinanceMarketingLegalOperationsSalesTemplatesPricingDocs
Get started

Run a Workflow

How to execute a workflow, provide input, and schedule recurring runs.

Overview

Running a workflow executes each step in order, passing data through the graph from start to finish. You can run a workflow immediately or schedule it to run on a recurring basis.

Starting a Run

There are two ways to start a run:

  • From the editor: Click the "Run" button in the workflow editor toolbar. This navigates you to the run creation page with your workflow pre-selected.
  • From the Runs page: Click "Create New Run," then select the workflow you want to run from the dropdown.

Configuring a Run

Before executing, you can configure a few options on the run creation page:

  • Title: An optional name for this run. If left blank, one is generated automatically.
  • Input Data: If your workflow starts with a Form step, you'll see input fields to fill out. This data becomes the first step's output, which downstream steps can map from.
  • Schedule: Optionally set a recurring schedule using a cron expression. Scheduled runs execute automatically at the specified times.

Run Now vs. Schedule

When you click "Run Now," the workflow begins executing immediately. You're redirected to the run detail page where you can watch the progress.

When you set a schedule, the workflow runs automatically at each scheduled time. Each execution creates a separate run that you can view on the Runs page.

Providing Input Data

If the first step in your workflow is a Form step, the run creation page displays a form for you to fill out. The fields in this form match the output field set defined on the Form step. This is how you inject data into the workflow at runtime. Downstream steps can map from the Form step's output fields.

If the workflow doesn't start with a Form step, no input is needed and the workflow runs with whatever data the first step generates on its own.

Monitoring a Run

After starting a run, you're taken to the run detail page. Here you can see the current status, which steps have completed, and any outputs produced. For more detail on reading run results and troubleshooting failures, see the Understanding Workflow Runs guide.

Tips
  • Test your workflow with a simple input first before scheduling recurring runs
  • Use descriptive run titles so you can identify specific runs later in the Runs list
  • If a Form step has required fields, the run won't start until all required fields are filled in
  • Scheduled runs use your account's timezone. Check the cron expression preview to confirm the schedule