Ikoula API Microsoft
Actions18
- Invoice Actions
- Licence Actions
- Microsoft Actions
- User Actions
Overview
This node interacts with the Ikoula Microsoft 365 API to manage Microsoft 365 user licenses and related account operations. Specifically, the "Unassign Licence From User" operation allows you to remove a particular license from a specified user within a Microsoft 365 subscription.
Common scenarios where this node is beneficial include:
- Managing user licenses in bulk or automated workflows.
- Revoking licenses when users leave an organization or change roles.
- Automating license lifecycle management as part of IT administration.
For example, if an employee leaves the company, you can use this node to unassign their Microsoft 365 license automatically, freeing it up for reassignment.
Properties
| Name | Meaning |
|---|---|
| Subscription ID | The ID of the Microsoft subscription under which the user and license exist. |
| User ID | The unique identifier of the user from whom the license will be unassigned. |
| Licence ID to Unassign | The unique identifier of the license that should be removed from the user. |
| Response Format | The format of the API response; options are JSON or XML. |
Output
The node outputs the response from the Ikoula Microsoft 365 API call in the json field. The structure depends on the API response format (JSON or XML) selected:
- If JSON is selected, the output will be a parsed JSON object representing the result of the unassignment operation.
- If XML is selected, the output will contain the raw XML response as a string inside the
dataproperty.
No binary data output is produced by this operation.
Dependencies
- Requires valid credentials for the Ikoula Microsoft 365 API, including an 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.comby 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/User ID/License ID: If any of these IDs are incorrect or do not exist, the API may return errors or fail silently. Verify the IDs before running the node.
- API Response Errors: The node passes through API errors. Check the returned JSON or XML for error messages indicating issues such as permission problems or invalid parameters.
- Network Issues: Connectivity problems to the Ikoula API endpoint will cause request failures. Confirm network access and API availability.
Links and References
- Ikoula Microsoft 365 API Documentation (provided by the developer Ascenzia)
- n8n HTTP Request Node Documentation (for understanding underlying HTTP calls)
This summary focuses on the "Unassign Licence From User" operation within the "User" resource of the Ikoula API Microsoft node.