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 integrates with the Ikoula Microsoft API to manage Microsoft 365 account-related resources, specifically focusing here on listing invoices for a given Microsoft subscription. It allows users to retrieve a list of invoices associated with their Microsoft 365 subscription by providing the subscription ID and specifying the desired response format (JSON or XML).

Common scenarios where this node is beneficial include:

  • Automating invoice retrieval for accounting or auditing purposes.
  • Integrating Microsoft 365 billing data into custom dashboards or reporting tools.
  • Periodically fetching invoice lists to monitor subscription costs.

For example, a user can configure this node to list all invoices for a specific Microsoft 365 subscription in JSON format, then use the output to generate financial reports or trigger alerts based on invoice data.

Properties

Name Meaning
Subscription ID The numeric ID of the Microsoft subscription for which to list invoices.
Response Format The format of the API response; options are JSON or XML.

Output

The node outputs an array of items, each containing a json field with the API response data:

  • When the response format is JSON, the json field contains parsed JSON data representing the list of invoices retrieved from the Microsoft 365 subscription.
  • When the response format is XML, the json field contains the raw XML string data under a data property.

Each output item corresponds to one input item processed, paired accordingly.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Ikoula API Microsoft service, including email, password, and optionally a custom API URL.
  • The node uses RSA public key encryption to encrypt the password before sending it to the API.
  • Network access to the Ikoula API endpoint (https://api.ikoula.com by default) is necessary.
  • No additional environment variables or n8n configurations beyond the credential setup are required.

Troubleshooting

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

  • Invalid Subscription ID or missing required parameters
    If the subscription ID is incorrect or missing, the API will likely return an error or empty results. Verify the subscription ID input.

  • API connectivity issues
    Network problems or incorrect API URLs can cause request failures. Confirm network connectivity and that the API URL is correct.

  • Response format errors
    Selecting XML format returns raw XML as a string inside the JSON output. Downstream nodes expecting JSON may fail unless they parse the XML manually.

Links and References

Discussion