Overview
This node is a polling trigger designed to integrate 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 activities in LearningSuite without manual intervention.
Common scenarios include:
- Automatically processing new content bundles as they are created.
- Responding to new custom popups added to the platform.
- Managing community engagement by reacting to new groups, forums, badges, or areas.
- Tracking member activity, such as onboarding new members or identifying inactive users who haven't logged in for a specified number of days.
For example, you could use this node to start a workflow that sends a welcome email whenever a new member is created or to 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 triggers 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 filter option to specify the Area Name or ID to limit forums triggering the node. |
| Not Logged in for Days | (Shown only if "Member Not Logged In for More Than X Days" event is selected) Number of days a user has not logged in to qualify as inactive. 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 entities related to the triggered event. The structure depends on the event type but generally includes all relevant fields returned by the LearningSuite API for that entity, such as:
- For bundle-related events: bundle details.
- For community events: area, badge, forum, or group details.
- For member events: member profile information.
If the event is "Member Not Logged In for More Than X Days," the output contains member records matching the inactivity criteria.
No binary data output is produced by this node.
Dependencies
- Requires connection to the LearningSuite API via an API key credential configured in n8n.
- Uses internal helper methods to paginate through API results and filter based on timestamps.
- Relies on the LearningSuite API endpoints for bundles, popups, groups, community areas, badges, forums, and members.
Troubleshooting
- Invalid Number of Days: When selecting the "Member Not Logged In for More Than X Days" event, entering a non-positive or invalid number for days will cause an error: "Please provide a valid number of days (> 0)." Ensure the input is a positive integer.
- No Data Returned: If no new events are detected since the last poll, the node returns no output. This is expected behavior.
- API Request Failures: Network issues or invalid API credentials may cause request failures. Verify API keys and network connectivity.
- Filtering Forums by Area: When filtering community forums by area ID, ensure the area ID exists and is correctly specified; otherwise, no forums will match.
Links and References
- LearningSuite API Documentation (example placeholder link)
- n8n Expressions Documentation
- n8n Polling Trigger Nodes Guide