Overview
This node is a polling trigger designed to work with the LearningSuite API. It periodically checks for specific events occurring within the LearningSuite platform and triggers workflows when those events happen. This is useful for automating responses to changes or updates in the LearningSuite environment without manual intervention.
Common scenarios include:
- Automatically reacting when new content bundles are created.
- Triggering workflows when new community forums or badges are added.
- Monitoring member activity, such as detecting members who have not logged in for a specified number of days.
- Responding to creation of groups, custom popups, or community areas.
For example, you could use this node to send welcome emails when a new member is created or notify moderators when a new community forum is established.
Properties
| Name | Meaning |
|---|---|
| This workflow will run on the schedule you define here once you activate it. For testing, you can also trigger it manually: by going back to the canvas and clicking 'execute workflow' |
Informational notice explaining how the workflow runs on schedule or can be triggered manually for testing. |
| Event | The specific LearningSuite event that should trigger the node. Options include: - Bundle Created - Custom Popup Created - Group Created - New Community Area - New Community Badge - New Community Forum - New Member Created - Member Not Logged In for More Than X Days |
| Community Forum Options | (Shown only if "New Community Forum" event is selected) Additional options related to community forums, specifically: - Area Name or ID: Select or specify the community area to filter forums by. |
| Not Logged in for Days | (Shown only if "Member Not Logged In for More Than X Days" event is selected) Number of days a member has been inactive (not logged in) to trigger the event. Must be at least 1. |
| Include Users Who Have Not Logged in Yet | (Shown only if "Member Not Logged In for More Than X Days" event is selected) Boolean option to include users who have never logged in since being added to the platform. |
Output
The node outputs an array of JSON objects representing the items matching the selected event criteria since the last poll time. Each object corresponds to an entity from the LearningSuite platform, such as a bundle, popup, group, community area, badge, forum, or member.
The exact structure of each output item depends on the event type but generally includes all relevant fields returned by the LearningSuite API for that entity.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the LearningSuite API via an API key credential configured in n8n.
- Uses internal methods to paginate through API results to fetch all new or updated items since the last check.
- For some options (e.g., selecting community areas), dynamic loading of options from the API is used.
Troubleshooting
- Invalid number of days for inactivity: If the "Not Logged in for Days" property is set to a non-positive number or invalid value, the node throws an error requesting a valid number greater than zero.
- No events detected: If no new items match the criteria since the last poll, the node returns no output, which is expected behavior.
- API connectivity issues: Failures to connect to the LearningSuite API or authentication errors will cause the node to fail. Ensure the API credentials are correctly configured and valid.
- Filtering by community area: When filtering community forums by area ID, ensure the correct ID is provided; otherwise, no forums may be returned.
Links and References
- LearningSuite API Documentation (example placeholder, replace with actual URL)
- n8n Expressions Documentation - for using expressions in property fields like Area ID selection