Ikoula API MicrosoftInstall

Overview

This node integrates with the Ikoula Microsoft 365 API to manage Microsoft 365 accounts, licences, users, and invoices. The "Force Synchronization" operation specifically triggers an immediate update of information on the Microsoft side for a given subscription. This is useful when you want to ensure that the latest data from Microsoft 365 is reflected promptly in your system after changes or updates.

Practical scenarios include:

• Forcing synchronization after manual changes in the Microsoft 365 admin portal to reflect those changes immediately in your workflows.
• Ensuring billing or licence status is up-to-date before generating reports or triggering further automation.
• Keeping user and licence data consistent between Microsoft 365 and other integrated systems.

Properties

Output

The node outputs the response from the Ikoula Microsoft 365 API call in the json field. The structure depends on the chosen response format:

• If JSON is selected, the output will be a parsed JSON object representing the API response.
• If XML is selected, the output will contain the raw XML string under the data property inside the json output.

The output corresponds to the result of forcing synchronization on the specified Microsoft subscription, typically confirming success or providing status details.

Dependencies

• Requires an API key credential for authentication with the Ikoula Microsoft 365 API.
• The node uses RSA public key encryption to encrypt the password before sending it to the API.
• The base URL for the API defaults to https://api.ikoula.com but can be overridden via credentials.
• No additional external dependencies are required beyond standard HTTP requests.

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without valid API credentials configured. Ensure you have set up the required API key credential with email, password, and optionally the API URL.

• Invalid Subscription ID
  If the subscription ID is incorrect or does not exist, the API may return an error or empty response. Verify the subscription ID is correct.

• API Response Errors
  Errors returned by the API (e.g., authentication failure, rate limits) will be passed through in the node output. Check the API credentials and usage limits.

• Response Format Issues
  Selecting XML format returns raw XML as a string; downstream nodes expecting JSON must handle this accordingly.

Links and References

• Ikoula Microsoft 365 API Documentation (provided by Ascenzia, developer of this integration)
• Microsoft 365 Admin Center (for managing subscriptions and licences)
• General n8n HTTP Request Node documentation for understanding request/response handling