Skip to main content

Workflow Trigger: Lesson Started

The Lesson Started workflow trigger enrolls a contact into a workflow the first time they begin a specific lesson, category, or course inside Kyrios Courses.

Updated over 2 months ago

Who This Is For / When to Use

Use this trigger if you want to:

  • Automate actions when a learner starts a lesson for the first time

  • Send lesson-specific emails, resources, or reminders

  • Track first engagement with course content

  • Branch workflows based on lesson, category, or product

What the Lesson Started Trigger Does

  • Fires once per contact per lesson/category/product

  • Triggers when a contact first starts a lesson

  • Does not re-fire if the same lesson is revisited later

Important Behavior Constraint

  • This trigger is one-time only

  • Repeat views of the same lesson will not trigger the workflow again

  • To track ongoing or repeated engagement, use additional workflows or conditions

Where to Find the Lesson Started Trigger

  1. Go to Automations β†’ Workflows

  2. Click Create Workflow or open an existing workflow

How to Add the Lesson Started Trigger

  1. Click Add New Trigger

  2. Search for Lesson

  3. Select Lesson Started under the Courses trigger group

How to Configure Lesson Started Filters

Filters control which lesson activity triggers the workflow.

Available Filters

  • Product – The course or membership

  • Category – The lesson category/module

  • Lesson – A specific lesson

Best Practice Order

  1. Product

  2. Category

  3. Lesson

This prevents unintended triggers across multiple courses.

Example: Triggering on a Specific Lesson

Example configuration:

  • Product: Membership demo course 1

  • Category: Introduction

  • Lesson: About Your Instructor

This workflow triggers only when that exact lesson is started for the first time.

Publishing Requirements for Lessons

The lesson must be published to trigger workflows.

Draft lessons do not fire triggers.

Using Conditions (If/Else) With Lesson Started

You can branch workflow logic after the trigger.

Example uses:

  • Different actions for different lessons

  • Separate onboarding paths by category

  • Conditional emails based on lesson started

Using Lesson Started Custom Values in Messages

You can personalize emails and messages using Lesson Started custom values.

Available examples include:

  • Lesson Title

  • Lesson URL

  • Category Title

  • Product Title

Access these by clicking the tag icon in message actions.

Testing and Publishing the Workflow

  1. Use Test Workflow to validate logic

  2. Toggle workflow status from Draft to Publish

  3. Monitor enrollments from the workflow execution log

Common Issues and Fixes

Trigger does not fire

  • Confirm the lesson is published

  • Verify the contact has not already started the lesson

  • Check Product and Category filters are correct

Workflow fires for the wrong lesson

  • Add a Lesson filter

  • Ensure Product is filtered first

Trigger fires only once

  • This is expected behavior

  • The Lesson Started trigger is first-interaction only

FAQ

What is the Lesson Started trigger used for?

The Lesson Started trigger enrolls a contact into a workflow when they start a lesson for the first time, allowing automated follow-ups, tracking, and personalization.

Can I target a specific lesson?

Yes. Use the Lesson filter, optionally combined with Product and Category filters, to trigger only on a specific lesson.

Will this trigger every time a lesson is opened?

No. It triggers only once per contact for the same lesson, category, or product.

Can I branch workflows by lesson?

Yes. Use If/Else conditions after the trigger to create different paths based on lesson, category, or product.

Can I personalize emails with lesson data?

Yes. Use Lesson Started custom values such as Lesson Title or Lesson URL inside message actions.

What if I have multiple courses?

Always filter by Product first. Without a Product filter, the trigger applies to lessons across all courses in the account.

Did this answer your question?