Overview
This node acts as a trigger for various instant webhook events from the LearningSuite platform. It listens for specific LearningSuite events and initiates workflows in n8n when those events occur. This is useful for automating processes based on user interactions, course progress, community activity, exams, feedback, and more within the LearningSuite environment.
Common scenarios include:
- Triggering actions when a new community post is created or moderated.
- Responding to changes in course progress or lesson completions.
- Reacting to member logins filtered by login type.
- Handling exam completions and grading events.
- Processing new access requests or submission creations.
- Monitoring group membership changes.
Practical examples:
- Automatically sending a congratulatory email when a member completes a lesson.
- Notifying moderators when a community post requires approval.
- Logging user login events filtered by authentication method.
- Updating CRM records when a member’s course progress crosses a threshold.
Properties
| Name | Meaning |
|---|---|
| Event | Select the LearningSuite instant event to listen for. Options include: Community Post Created, Community Post Moderated, Course Progress Changed, Custom Popup Interaction, Exam Completed, Exam Graded, Group User Access Changed, Lesson Completed, New Access Request, New Feedback Created, New Login, Submission Created. |
| Login Options | (Shown only if Event = "New Login") Filters for login events by login type (All, App Email Code, Email & Password, Google, Magic Link, OIDC, Password Reset) and optionally by user name or ID. |
| Popup Interaction Options | (Shown only if Event = "Custom Popup Interaction") Filters popup interaction events by popup name/ID, interaction type (All, Actioned, Dismissed), and optionally by user name or ID. |
| Course Progress Above (%) | (Shown only if Event = "Course Progress Changed") Numeric threshold (1-100) specifying the minimum course progress percentage to trigger the event. |
| Course Progress Options | (Shown only if Event = "Course Progress Changed") Optional filter by course name or ID. |
| Community Post (Created) Options | (Shown only if Event = "Community Post Created") Optional filters by area name/ID, forum name/ID, publish status (Both, Published, Waiting for Moderation), and user name or ID. |
| Community Post (Moderated) Options | (Shown only if Event = "Community Post Moderated") Optional filters by area name/ID, forum name/ID, approved status (Both, Approved, Rejected), and user name or ID. |
| Feedback/Exam Options | (Shown only if Event = "Feedback Created", "Exam Completed", or "Exam Graded") Optional filter by course name or ID. |
| Course Name or ID | (Shown only if Event = "New Access Request") Required filter by course name or ID. |
| Action | (Shown only if Event = "Group User Access Changed") Specifies whether a member was added or removed from a group. |
| Group Access Options | (Shown only if Event = "Group User Access Changed") Optional filter by group name or ID. |
| Lesson Completed Options | (Shown only if Event = "Lesson Completed") Optional filters by course name/ID, module name/ID, and lesson name/ID. |
| Submission Options | (Shown only if Event = "Submission Created") Optional filter by course name or ID. |
Output
The node outputs JSON data representing the payload received from the LearningSuite webhook event. The structure of this JSON depends on the specific event triggered but generally includes detailed information about the event context such as user details, course/module identifiers, post content, exam results, etc.
If multiple events are received at once, the output will be an array of JSON objects, each corresponding to one event.
No binary data output is indicated.
Dependencies
- Requires a valid API key credential for authenticating with the LearningSuite API.
- The node uses LearningSuite's webhook subscription API to manage webhook registrations automatically.
- Several dynamic option loaders depend on LearningSuite API endpoints to populate dropdowns (e.g., members, courses, groups, popups).
- Proper configuration of the webhook URL in n8n is necessary to receive events.
Troubleshooting
- Webhook Subscription Errors: Errors during webhook creation, update, or deletion may occur due to invalid API keys, network issues, or incorrect webhook URLs. Ensure the API key is valid and the webhook URL is accessible publicly.
- Event Filtering Issues: If no events trigger the workflow, verify that the selected event and filters match actual events occurring in LearningSuite.
- Missing Data in Output: If the output JSON contains
{error:"No JSON body"}, it indicates the webhook payload was empty or malformed. Check LearningSuite webhook settings and event configurations. - 404 Errors on Webhook Verification: This means the webhook subscription does not exist or was deleted externally. The node attempts to recreate it automatically.
- Load Options Failures: Dropdowns for selecting users, courses, groups, etc., rely on API calls. Failures here usually indicate credential or permission issues.
Links and References
- LearningSuite API Documentation (general reference for API endpoints)
- n8n Expressions Documentation (for using expressions in property fields)
- n8n Webhook Node Documentation (conceptual understanding of webhook triggers)