Create and Test a Workflow
Build a workflow, test it on a real record, turn it on and read Run History.
Build a workflow in the drag-and-drop builder, test it against a real record, then turn it on.
Create a workflow
- Go to Workflows > Create New Workflow (or click Create Workflow on the Workflows List).
- Choose a template, or a blank Account, Contact or Product workflow.
- Enter a name at the top of the page, and optionally a description.
- Check Runs for. It can only be changed before the first save. To change it later, Duplicate the workflow.
Build the steps
The builder has three parts: the palette of triggers, logic and actions on the left, the canvas in the middle and the settings panel for the selected step on the right. The palette only shows steps that work with your Runs for and trigger.
- Set the trigger. Click a trigger in the palette, or click the trigger card and choose one in the settings panel. Fill in its options, such as Only orders placed from: Storefront.
- Add a step. Click + in the flow and choose If / Else, Delay or an action. You can also click a palette item to add it to the end of the flow.
- Set conditions. Click the If / Else step:
- Choose a field, an operator and a value.
- Click Add rule for more conditions, and choose ALL (every rule must be true) or ANY (one is enough).
- For order and spend fields, choose a time window: in the last N days, this period or previous period (see Workflow Triggers, Conditions and Actions).
- Add actions to the branches. Click + under Yes or No. Steps placed below the Yes or No marker run whichever branch was taken.
- Fill in each step's settings. A red ! marks a step that still needs a value.
| To… | Do this |
|---|---|
| Edit a step | Click it. Its settings open on the right. |
| Move a step | Drag it to another +, including into or out of a branch. |
| Duplicate or delete a step | Use the icons on the step card. Deleting an If / Else also deletes every step inside its branches. |
| Undo | Click Undo or press Ctrl+Z. |
Allow re-enrollmentBy default, an account, contact or product can complete a workflow only once. Turn on Allow re-enrollment for workflows that should run every time, such as a monthly program, a loyalty credit on every order, or a product flag that's re-checked on each order.
Test the workflow
Test runs the current workflow, saved or not, against a real record and shows what each step would do. Nothing is changed.
- Click Test.
- Search for an account (name or ID), contact (email or ID) or product (SKU or ID), and pick it from the list.
- For order triggers, enter an Order # so order conditions such as Order quantity of SKUs can be checked.
- Click Run test and read the result, for example:
- Completed: "Would move account "Acme Supply" to group "Wholesale 2"."
- No Changes: the conditions weren't met, or the record was already in that state.
- Failed: a step couldn't run, with the reason, such as an account with no sales rep.
Turn it on
- Turn the Active toggle on, or click Activate and save in the yellow banner.
- Click Save.
If the workflow is missing a required value, it's saved as inactive and the missing items are listed.
Check what ran
Open the workflow and scroll to Run History. Each row is an account, contact or product that entered the workflow, with the order # for order triggers. Click Show to read the step-by-step log.
| Status | Meaning |
|---|---|
| Pending | Queued to run. |
| Waiting (Delay) | Paused on a Delay step until the Resumes time. |
| Completed | At least one action changed something. |
| No Changes | Conditions weren't met, or there was nothing to change (for example, already in that group). |
| Retry Scheduled | A step failed and will be retried at the Resumes time (up to 5 retries). |
| Failed | A step failed after every retry. The log shows why. |
| Canceled | The workflow was turned off or deleted while the run was waiting. |
The Workflows List shows the Completed, In Progress and Failed counts for each workflow.
Change, pause or remove a workflow
- Edit while runs are waiting: if you change the steps while runs are queued or waiting on a delay, you're asked whether those runs should use the new steps or keep the previous steps.
- Pause: turn the workflow off and save. Runs that were waiting are canceled.
- Copy: Duplicate creates an inactive copy, for example to change Runs for.
- Delete: Delete removes the workflow and its run history.
- Several at once: on the Workflows List, select workflows and use Bulk Actions to Activate, Deactivate or Delete.
- Audit Log: the bottom of each saved workflow shows who changed what, and when.
Updated about 3 hours ago
