Ikoula API MicrosoftInstall

Overview

This node integrates with the Ikoula Microsoft 365 API to manage various aspects of Microsoft 365 accounts, licences, users, invoices, and related resources. Specifically, for the User resource and the Get User Resources operation, it retrieves mandatory resources required for user creation and modification within a specified Microsoft subscription.

Typical use cases include:

• Automating retrieval of necessary user-related metadata or configuration details before creating or updating Microsoft 365 users.
• Integrating with workflows that provision or modify users in Microsoft 365 by first fetching required resource information.
• Ensuring compliance with Microsoft 365 account requirements by programmatically accessing up-to-date user resource data.

Example: Before creating a new user in Microsoft 365 via automation, this node can fetch the required user resource templates or constraints to ensure the user data complies with Microsoft’s expectations.

Properties

Output

The node outputs the API response under the json field. The structure depends on the chosen response format:

• If JSON is selected, the output will be a parsed JSON object containing the user resource details as provided by the Ikoula Microsoft API.
• If XML is selected, the output will contain the raw XML string data representing the user resources.

No binary data output is produced by this operation.

Dependencies

• Requires an API key credential for the Ikoula Microsoft API, including email and password credentials.
• The node uses RSA public key encryption to encrypt the password before sending requests.
• The base URL for the API defaults to https://api.ikoula.com but can be overridden in credentials.
• Proper network access to the Ikoula API endpoint is necessary.

Troubleshooting

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

• HTTP request failures or unexpected responses:
  Verify that the Subscription ID is correct and that the API service is reachable. Also, confirm that the response format matches the expected type (JSON or XML).

• Incorrect or missing parameters:
  The Subscription ID is mandatory. Omitting it or providing an invalid value will cause errors.

• Encryption issues:
  The node encrypts the password using a fixed RSA public key. If the API changes its encryption requirements, the node may fail to authenticate.

Links and References

• Ikoula Microsoft 365 API Documentation (official developer site referenced in node description)
• Microsoft 365 User Management Concepts (for understanding user resources and licenses)

If you need details about other operations or resources, feel free to ask!