Ikoula API MicrosoftInstall

Overview

This node integrates with the Ikoula Microsoft 365 API to manage Microsoft 365 accounts and related resources. It allows users to perform various operations such as listing Microsoft accounts, retrieving account details, forcing synchronization, managing licenses, handling users, and accessing invoices.

The List Accounts operation specifically retrieves a list of all Microsoft 365 accounts associated with the authenticated subscription. This is useful for administrators who want to get an overview of all their Microsoft accounts managed through Ikoula’s platform.

Practical examples:

• An IT administrator wants to fetch all Microsoft 365 accounts to audit active subscriptions.
• A workflow needs to retrieve account lists to trigger further automation like license assignment or user management.
• Integration with reporting tools to display current Microsoft 365 accounts status.

Properties

Output

The output contains a JSON object representing the API response from the Ikoula Microsoft 365 service.

• For the List Accounts operation, the json field will contain the list of Microsoft accounts retrieved from the /microsoft endpoint.
• If the response format is set to XML, the raw XML string is returned inside the data property of the JSON output.
• The output is paired with the input item index for traceability in workflows.

No binary data output is produced by this node.

Dependencies

• Requires valid credentials for the Ikoula API, including email, password, and optionally a custom API URL.
• The password is encrypted using RSA public key encryption before being sent.
• The node makes HTTP requests to the Ikoula API endpoints.
• No additional external dependencies beyond standard n8n HTTP request helpers.

Troubleshooting

• No credentials provided!
  Error thrown if the required API credentials are missing. Ensure that the node has been configured with valid Ikoula API credentials.

• HTTP request errors
  Network issues, invalid credentials, or incorrect parameters may cause HTTP errors. Check the API credentials, subscription ID, and other parameters.

• Invalid subscription ID or resource IDs
  Operations requiring subscription ID or other IDs must have valid numeric/string values. Verify these inputs.

• Response format issues
  If XML format is selected, downstream nodes expecting JSON might fail. Use JSON format unless XML is explicitly needed.

• Continue on Fail
  If enabled, errors for individual items will be captured in the output JSON under an error property instead of stopping execution.

Links and References

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

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