Ikoula API Microsoft
Actions18
- Invoice Actions
- Licence Actions
- Microsoft Actions
- User Actions
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
dataproperty inside thejsonfield.
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
- Ikoula Microsoft API Documentation (official site referenced in node description)
- Microsoft 365 Licensing Overview (for understanding license types)