CIPP

Interact with CIPP API

Actions18

Calendar Permission Actions
- List Calendar Permissions
- Edit Calendar Permissions
Group Actions
License Actions
- Create Or Update Excluded Licenses
- List Licenses
Tenant Actions
User Actions

Overview

The "Edit Group" operation in the Group resource allows users to modify group membership and ownership within a tenant. This node is useful for managing access control and collaboration by programmatically adding or removing members and owners from a specified group. Practical applications include automating user management workflows, synchronizing group memberships with external systems, or updating group roles based on organizational changes.

Properties

Name	Meaning
Tenant ID	The unique identifier of the tenant where the group exists.
Group ID	The unique identifier of the group to be edited.
Add Member By GUID	Adds a member to the group using their globally unique identifier (GUID).
Add Owner By GUID	Adds an owner to the group using their GUID.
Remove Member by GUID	Removes a member from the group using their GUID.
Remove Owner By GUID	Removes an owner from the group using their GUID.

Output

The node outputs JSON data representing the result of the edit operation on the group. This typically includes confirmation of the changes made, such as updated lists of members and owners or status messages indicating success or failure. There is no indication that binary data is output by this node.

Dependencies

Requires an API key credential for authentication to the CIPP API.
The base URL for API requests is constructed dynamically from the provided credentials.
Proper configuration of the API URL and OAuth2 credentials in n8n is necessary for successful execution.

Troubleshooting

Common Issues:
- Invalid or missing Tenant ID or Group ID will cause the operation to fail.
- Providing incorrect GUIDs for members or owners may result in errors or no changes applied.
- Insufficient permissions associated with the API credentials can prevent modifications.
Error Messages:
- Errors related to authentication usually indicate misconfigured or expired API credentials.
- Validation errors may occur if required fields are empty or malformed.
Resolutions:
- Verify that all required IDs and GUIDs are correct and exist in the target system.
- Ensure the API credentials have sufficient permissions to edit groups.
- Check network connectivity and API endpoint correctness.

Links and References

Refer to the official CIPP API documentation for detailed information on group management endpoints.
Consult n8n documentation on setting up OAuth2 credentials and configuring HTTP request nodes for API integration.