Triggering workflows
Knock executes workflow runs when workflows are triggered. A workflow can be triggered in these ways:
- By a direct API call to the
trigger
endpoint - By a source event
- On a recurring, or one-off schedule
- When a user becomes a member of an audience
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.