Ikoula API Microsoft icon

Ikoula API Microsoft

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

Actions18

Overview

This node interacts with the Ikoula Microsoft 365 API to manage Microsoft 365 licences associated with a subscription account. Specifically, the "List Account Licences" operation retrieves all licences linked to a given Microsoft subscription ID.

Common scenarios where this node is beneficial include:

  • Auditing or reporting on all licences currently assigned to a Microsoft 365 subscription.
  • Integrating licence data into workflows for license management automation.
  • Monitoring licence usage and availability within an organization.

For example, a user can input a Subscription ID to fetch all licences tied to that subscription in JSON or XML format, then use this data downstream to update internal asset management systems or trigger alerts if licences are nearing expiration.

Properties

Name Meaning
Subscription ID The numeric ID of the Microsoft subscription whose licences you want to list.
Response Format The format of the API response; options are: json (default) or xml.

Output

The node outputs an array of items, each containing a json field with the API response data. For the "List Account Licences" operation, the json field includes the details of licences associated with the specified subscription.

  • If the response format is JSON, the output will be parsed JSON objects representing licence information.
  • If the response format is XML, the raw XML string is returned inside the data property of the JSON output.

No binary data output is produced by this operation.

Dependencies

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

Troubleshooting

  • No credentials provided!
    This error occurs if the node is executed without configured API credentials. Ensure that the required API key credential is set up correctly in n8n.

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

  • API Response Errors
    Network issues, invalid credentials, or API downtime can cause request failures. Check network connectivity and credential validity.

  • Response Format Issues
    Selecting XML format returns raw XML as a string inside the JSON output's data property. Downstream nodes expecting JSON should use the JSON format option.

Links and References

Discussion