CIPP icon

CIPP

Interact with CIPP API

Actions18

Overview

The node named "CIPP" provides integration with the CIPP API, allowing users to interact programmatically with various resources such as Users, Tenants, Groups, Licenses, and Calendar Permissions. Specifically, for the "User" resource and the "Exec Restore Deleted User" operation, this node enables restoring a previously deleted user within the system.

This functionality is beneficial in scenarios where a user account was accidentally deleted or needs to be reinstated without recreating it from scratch. For example, an administrator can restore access for a user who was removed due to a mistake or temporarily deactivated.

Properties

Name Meaning
ID The unique identifier of the user to restore.
Tenant Filter The tenant context to apply the operation in, specified either by tenant ID or domain name (e.g., "n8layer.com"). This ensures the correct tenant scope for the user restoration.

Output

The node outputs JSON data representing the result of the restore operation. This typically includes details about the restored user, such as their ID, status, and any relevant metadata returned by the CIPP API confirming the successful restoration.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the CIPP API.
  • Needs an API authentication token configured via OAuth2 credentials within n8n.
  • The base URL for the API is dynamically set based on the provided credential configuration.
  • Proper permissions are required on the API side to perform user restoration actions.

Troubleshooting

  • Common Issues:

    • Invalid or missing user ID: Ensure the "ID" property is correctly set to the user intended for restoration.
    • Incorrect tenant filter: Verify that the tenant ID or domain name matches the user's tenant context.
    • Authentication errors: Confirm that the OAuth2 credentials are valid and have not expired.
    • Insufficient permissions: The API token must have rights to restore deleted users.

  • Error Messages:

    • "User not found": The specified user ID does not exist or is not deleted; verify the ID.
    • "Unauthorized" or "Forbidden": Check API credentials and permissions.
    • "Tenant mismatch": The tenant filter does not correspond to the user's tenant; adjust accordingly.

Resolving these usually involves verifying input parameters, refreshing credentials, and ensuring proper API access rights.

Links and References

Discussion