Infomaniak CoreResources icon

Infomaniak CoreResources

Interact with Infomaniak API

Actions28

Overview

This node interacts with the Infomaniak API to manage various resources, including kSuite workspaces. Specifically, for the kSuite resource and the Get Workspace Users operation, it retrieves the list of users associated with the current user's kSuite workspace mailboxes.

This operation is useful when you want to programmatically access or audit the users who have access to a particular kSuite workspace, for example, to synchronize user lists, monitor mailbox assignments, or integrate user data into other systems.

Practical Example

  • Automatically fetch all users linked to your kSuite workspace to update an internal directory.
  • Use the retrieved user data to trigger notifications or workflows based on mailbox ownership or permissions.

Properties

Name Meaning
Sub Resource Selects the sub-area within kSuite; options are:
- Workspace (workspace and mailbox operations)
- My kSuite (personal management)
- Product Management (product-related operations)
Additional Options For "My kSuite" sub-resource only; allows specifying additional data to load via the "With" string parameter.

For this specific operation ("Get Workspace Users"), the relevant property is:

Name Meaning
Sub Resource Must be set to "Workspace"
Operation Must be set to "Get Workspace Users"

No additional input parameters are required for this operation.

Output

The output is a JSON array where each item represents a workspace user related to the current user's kSuite mailboxes. The exact structure depends on the API response but typically includes user details such as identifiers, email addresses, roles, and mailbox associations.

The node does not output binary data for this operation.

Example output snippet (conceptual):

[
  {
    "id": "user-id-123",
    "email": "user@example.com",
    "name": "User Name",
    "mailboxId": "mailbox-id-456",
    "role": "member"
  },
  ...
]

Dependencies

  • Requires an API key credential for Infomaniak API authentication.
  • The node makes HTTP requests to the Infomaniak API endpoint: https://api.infomaniak.com/2/profile/ksuites/mailboxes.
  • Proper configuration of the Infomaniak API credentials in n8n is necessary.

Troubleshooting

  • Failed to retrieve workspace users: This error indicates that the API request did not succeed. Possible causes include invalid or expired API credentials, network issues, or insufficient permissions.

    • Verify that the API key credential is valid and has the necessary scopes.
    • Check network connectivity.
    • Ensure the authenticated user has access to the kSuite workspace.

  • Empty result: If no users are returned, confirm that the workspace actually has users assigned and that the authenticated account is correct.

  • HTTP errors or unexpected responses: Review the API documentation and ensure that the Infomaniak service is operational.

Links and References

Discussion