Docs
/
/
Platform
Send messages
Triggering workflows
Overview

Triggering workflows

Learn more about how to trigger cross-channel notification workflows in Knock.

Knock executes workflow runs when workflows are triggered. A workflow can be triggered in these ways:

Conditionally executing a workflow trigger

#

A trigger step can have one or more step conditions that determine if the workflow executes. When conditions evaluate to false, the workflow terminates and no other steps execute.

Controlling workflow trigger frequency

#

Sometimes you need to limit how often a recipient runs through a workflow. For example, you might want an account signup workflow to run only once per recipient. Workflow trigger frequency controls this behavior.

Trigger frequency lets you set if a workflow should run every time or at most once per recipient. By default, workflows trigger every time for a recipient.

When you specify "Once per recipient" frequency, you can include the tenant in this control. This ensures your workflow triggers once per-recipient, per-tenant.

Frequently asked questions

#

A workflow whose status is set to Inactive will return a workflow_inactive error when triggered and will not generate any workflow recipient runs.

No. Trigger frequency is not enforced by the workflow test runner. Settings like "once per recipient" are bypassed — the workflow will execute for the selected recipient every time you run a test, regardless of your frequency setting. This is expected behavior. To test trigger frequency as it works in production, trigger the workflow via the trigger API directly.

New chat