Ikoula API Microsoft icon

Ikoula API Microsoft

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

Actions18

User → Assign Licence to User

AI-generated

Overview

This node integrates with the Ikoula Microsoft 365 API to manage Microsoft 365 user licenses and other related resources. Specifically, the "Assign Licence to User" operation allows you to assign one or more available Microsoft 365 licenses to a specified user within a given subscription.

Common scenarios where this node is beneficial include:

  • Automating license assignment when onboarding new employees.
  • Managing license allocation dynamically based on user roles or department changes.
  • Integrating license management into broader IT workflows for Microsoft 365 administration.

For example, after creating a new user in Microsoft 365, you can use this node to assign the required licenses automatically by providing the subscription ID, user ID, and a list of license IDs to assign.

Properties

Name Meaning
Subscription ID The ID of the Microsoft subscription under which the user exists and licenses are managed.
User ID The unique identifier of the user to whom licenses will be assigned.
Licences to Assign A comma-separated list of license IDs that should be assigned to the specified user.
Response Format The format of the API response; options are JSON or XML.

Output

The node outputs the response from the Ikoula Microsoft API call in the json field. This response contains the result of the license assignment operation, typically confirming success or detailing any errors returned by the API.

If the response format is set to JSON (default), the output will be a parsed JSON object. If XML is selected, the raw XML string is returned inside the data property of the JSON output.

The node does not output binary data.

Dependencies

  • Requires an API key credential for the Ikoula Microsoft API, including email and password credentials used for authentication.
  • The node uses RSA public key encryption to encrypt the password before sending it to the API.
  • The base URL for the API defaults to https://api.ikoula.com but can be overridden via credentials.
  • Proper configuration of the Ikoula API credentials in n8n is necessary for successful operation.

Troubleshooting

  • No credentials provided!: This error occurs if the node is executed without valid Ikoula API credentials configured. Ensure that the API key credential with email and password is set up correctly.
  • Invalid User ID or Subscription ID: If the user or subscription identifiers are incorrect or do not exist, the API may return errors. Verify these IDs before running the node.
  • License IDs format: The "Licences to Assign" property must be a comma-separated string of valid license IDs. Incorrect formatting or invalid license IDs will cause the API to reject the request.
  • API response errors: If the API returns an error, it will be included in the node's output JSON. Review the error message for details and adjust parameters accordingly.
  • Network or connectivity issues: Ensure that the n8n instance has internet access and can reach the Ikoula API endpoint.

Links and References

Discussion