Ikoula API Microsoft icon

Ikoula API Microsoft

Interact with Ikoula Microsoft API for Microsoft 365 account management. Developed by Ascenzia - www.ascenzia.fr

Overview

This node interacts with the Ikoula Microsoft API to manage Microsoft 365 user licenses and related user data. Specifically, the "Get Available Licences for User" operation retrieves a list of licenses that can be allocated to a specified user within a given Microsoft subscription.

Common scenarios where this node is beneficial include:

  • Automating license management workflows by fetching available licenses before assigning them to users.
  • Integrating license availability checks into broader user provisioning or auditing processes.
  • Building dashboards or reports that show which licenses are available for allocation to specific users.

For example, an IT administrator could use this node in an automation workflow to first check what licenses are available for a new employee’s account before assigning the appropriate license.

Properties

Name Meaning
Subscription ID The ID of the Microsoft subscription under which the user exists.
User ID The unique identifier of the user for whom available licenses are being queried.
Response Format The format of the API response; options are JSON or XML.

Output

The node outputs the API response in the json field of the output data. The structure depends on the chosen response format:

  • If JSON is selected, the output will be a parsed JSON object containing details about the licenses available for the specified user.
  • If XML is selected, the output will contain the raw XML response as a string under the data property inside the json field.

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • No credentials provided!
    This error occurs if the node cannot find the required API credentials. Ensure that the Ikoula API credentials are correctly set up in n8n.

  • HTTP request failures
    Network issues, incorrect subscription or user IDs, or invalid API keys may cause request failures. Verify all input parameters and credentials.

  • Invalid User ID or Subscription ID
    If the user or subscription does not exist or is mistyped, the API may return errors or empty results. Double-check these IDs.

  • Response format issues
    Selecting XML format returns raw XML strings, which might require additional parsing downstream.

Links and References

Discussion