Ikoula API MicrosoftInstall

Overview

This node integrates with the Ikoula Microsoft 365 API to manage Microsoft 365 users and related resources. Specifically, the "List Users" operation under the "User" resource retrieves a list of users associated with a specified Microsoft 365 subscription.

Common scenarios for this node include:

• Retrieving all users linked to a Microsoft 365 subscription for reporting or auditing.
• Synchronizing user lists from Microsoft 365 into other systems.
• Automating workflows that require user data from Microsoft 365 accounts.

For example, an IT administrator could use this node to fetch all users in a subscription to verify license assignments or to export user details for compliance purposes.

Properties

Output

The output is an array where each item corresponds to one input execution. For the "List Users" operation, the json field contains the API response data representing the list of users linked to the specified Microsoft 365 subscription.

• If the response format is JSON, the json field will contain a parsed JSON object with user details.
• If the response format is XML, the json field will contain the raw XML string under a data property.

No binary data output is produced by this operation.

Dependencies

• Requires valid credentials for the Ikoula Microsoft 365 API, including an email, password, and API URL.
• The password is encrypted using RSA public key encryption before being sent.
• The node makes HTTP requests to the Ikoula API endpoint (default: https://api.ikoula.com).
• Proper configuration of the API credentials within n8n is necessary.

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without configured API credentials. Ensure that the required API authentication token or credentials are set up correctly in n8n.

• API request failures
  Network issues, invalid subscription IDs, or incorrect parameters may cause HTTP errors. Verify the subscription ID is correct and that the API service is reachable.

• Response format issues
  Selecting XML format returns raw XML as a string inside the JSON output. Downstream nodes expecting JSON should use the JSON format option.

• Permission errors
  Insufficient permissions on the Microsoft 365 account or API credentials may result in authorization errors. Confirm that the API key has adequate rights.

Links and References

• Ikoula Microsoft 365 API Documentation (official site referenced in node description)
• n8n HTTP Request Node Documentation (for understanding HTTP request handling)