Kaizen Activity Trigger
Trigger workflows when activity conditions are met (streaks, completions, milestones, bucket events)
The Kaizen Activity trigger runs workflows when user activity conditions are met. Use it for streak rewards, completion milestones, level achievements, or bucket events (todo added/removed, bucket created). Supports public triggers so any user who meets the condition can fire the workflow, not just the workflow owner.
Block Type
kaizen_activityTrigger Configuration
Configure the condition in the block's trigger settings. Common condition types:
- Streak: Current streak reaches a target (e.g. 7-day streak)
- Completion milestone: Total completions (e.g. 100 completions)
- Todo completed: First completion, Nth completion, or any completion of a todo
- Bucket events: Todo added to bucket, todo removed from bucket, bucket created
- Level / points: User reaches a level or earns points
Options:
- Public Trigger: When enabled, the workflow runs for any user who meets the condition (e.g. community challenges). When disabled, only the workflow owner triggers it.
- Trigger Once: For one-time achievements, prevents the same user from triggering again.
- Cooldown: Minimum time between triggers per user (e.g. to avoid spam).
Outputs (Reference in Downstream Blocks)
Use <block_id.output_name> to pass trigger data to the next blocks.
| Output | Type | Description |
|---|---|---|
eventId | string | Unique ID of the triggering event |
eventType | string | e.g. TODO_COMPLETED, STREAK_MILESTONE |
triggeredAt | string | ISO timestamp when trigger fired |
userId | string | ID of user who met the condition |
username | string | Username of user who met the condition |
currentStreak | number | User's current streak count |
bestStreak | number | User's best streak count |
totalCompletions | number | User's total completions |
todoId | string | ID of the completed todo (if applicable) |
todoTitle | string | Title of the completed todo (if applicable) |
bucketId | string | ID of bucket (if applicable) |
pointsEarned | number | Points earned in the event |
currentLevel | number | User's current level |
condition | object | Details of the condition that was met |
Common Use Cases
Streak Reward: Notify on 7-Day Streak
Configure the trigger for "Streak reaches 7". In the next block (e.g. Unlock Badge or Send Notification), reference <kaizen_activity_1.userId> so the reward goes to the user who achieved the streak.
Unlock Badge on Milestone
- Kaizen Activity trigger: condition = "Total completions reaches 100".
- Unlock Badge block:
userId=<kaizen_activity_1.userId>,badgeId= your milestone badge ID.
Match Discovery Prompt on Todo Completion
- Kaizen Activity trigger: e.g. "Any todo first completion".
- Match Discovery Prompt block:
todoIdReference=<kaizen_activity_1.todoId>,userIdfrom trigger context. - Condition block: branch on
hasMatches == trueto notify or suggest completion.
Auto-Hide When Todo Added to Bucket
- Kaizen Activity trigger: "Todo added to bucket" (optionally filter by bucket).
- Kaizen Hide Todos block: hide the todo(s) using trigger output (e.g. todoId from event).
Public Community Challenge
Enable Public Trigger so every user who meets the condition (e.g. 30-day streak) runs the workflow. Use <kaizen_activity_1.userId> in Unlock Badge or notifications so each user gets their own reward.
Referencing Trigger Outputs
Use block output references in downstream blocks:
# Unlock Badge – award to the user who triggered
userId: "<kaizen_activity_1.userId>"
# Match Discovery Prompt – check the completed todo
todoIdReference: "<kaizen_activity_1.todoId>"For triggers, use <block_id.outputName> syntax (e.g. <kaizen_activity_1.userId>). In some UI fields you may see {{trigger.userId}}; both refer to the trigger's output for the user who triggered the workflow.