Actions56
- API Call Actions
- Bundle Actions
- Community Actions
- Course Actions
- Group Actions
- Hub Actions
- Member Actions
- Module Actions
- Popup Actions
- Webhook Actions
Overview
This node integrates with the LearningSuite API to manage groups and their members. Specifically, the "Add Members to Groups" operation allows users to add one or more users to one or more groups within the LearningSuite platform. This is useful in scenarios such as onboarding new employees into training groups, managing course access by grouping users, or organizing users for targeted communications.
Practical examples include:
- Adding a batch of new users to a specific training group after hiring.
- Assigning users to multiple groups based on their roles or departments.
- Automating group membership updates as part of a larger workflow involving user management.
Properties
| Name | Meaning |
|---|---|
| Group Names or IDs | Select one or more groups by name or ID to which users will be added. You can choose from a list loaded dynamically or specify IDs using expressions. Supports multiple selections. |
| User Name or IDs | Select one or more users by name or ID to add to the selected groups. Options are loaded dynamically or can be specified via expressions. Supports multiple selections. |
| Additional Options | Collection of optional settings: - Disable Access Notification Email: Boolean flag to disable sending an access notification email to users when they are added to groups. Defaults to false (email sent). |
Output
The node outputs a JSON array where each item corresponds to the result of adding users to groups. The structure typically includes confirmation details about the updated group memberships or any relevant response data from the LearningSuite API.
If the operation encounters errors for specific inputs and "Continue On Fail" is enabled, the output will include error messages alongside the input data that caused them.
No binary data output is involved in this operation.
Dependencies
- Requires a valid API authentication token configured in the node credentials to connect to the LearningSuite API.
- The node depends on dynamic loading methods to fetch available groups and users for selection.
- Network connectivity to the LearningSuite API endpoint specified in the credentials is necessary.
Troubleshooting
Common Issues:
- Selecting invalid or non-existent group or user IDs may cause errors.
- Lack of proper API permissions can result in authorization failures.
- Network issues or incorrect base URL configuration can prevent successful API calls.
Error Messages:
"No handler for resource "group" and operation "addMembers": Indicates a misconfiguration or unsupported operation; verify the resource and operation names.- API errors returned from LearningSuite (e.g., permission denied, not found) will be surfaced in the node's error output.
Resolutions:
- Ensure group and user IDs are correct and exist in the system.
- Verify API credentials have sufficient permissions.
- Check network connectivity and base URL correctness.
- Enable "Continue On Fail" to handle partial failures gracefully.
Links and References
- LearningSuite API Documentation (general reference, replace with actual API docs if available)
- n8n Expressions Documentation – for specifying dynamic values in properties
- n8n official documentation on Creating Custom Nodes