CIPP icon

CIPP

Interact with CIPP API

Actions18

Overview

The node named "CIPP" provides integration with the CIPP API, allowing users to interact with various resources such as Users, Groups, Tenants, Licenses, and Calendar Permissions. Specifically, for the User resource and the List User Groups operation, this node retrieves the groups associated with a specified user within a tenant.

This functionality is useful in scenarios where you need to manage or audit user group memberships programmatically, for example:

  • Automating access control reviews by listing all groups a user belongs to.
  • Synchronizing user group data between systems.
  • Generating reports on user permissions based on group membership.

Properties

Name Meaning
User ID The unique identifier of the user whose groups you want to list.
Tenant Filter The tenant ID that filters the scope of the user and their groups within the organization.

Output

The node outputs JSON data representing the list of groups the specified user belongs to. Each item in the output typically contains details about a group, such as its ID, name, and possibly other metadata depending on the CIPP API response structure.

If the node supports binary data output (not indicated here), it would be used to represent any file or media content returned by the API, but for this operation, the output is purely JSON.

Dependencies

  • Requires an active connection to the CIPP API.
  • Needs an API authentication token configured via OAuth2 credentials in n8n.
  • The base URL for the API is dynamically set from the credential's ApiUrl property.
  • Proper permissions on the API side to read user group information.

Troubleshooting

  • Missing or invalid User ID or Tenant Filter: Ensure these required fields are correctly filled; otherwise, the API call will fail.
  • Authentication errors: Verify that the OAuth2 credentials are valid and have not expired.
  • API endpoint issues: Confirm that the base URL is correct and the CIPP API service is reachable.
  • Empty group list: This might indicate the user does not belong to any groups or incorrect tenant filtering.

Links and References

Discussion