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 365 API to manage Microsoft 365 user accounts and related resources. Specifically, the "Update User" operation allows updating details of an existing Microsoft 365 user within a specified subscription. This is useful for scenarios where user information such as name, email, domain, or country needs to be modified after account creation.

Practical examples include:

  • Correcting or updating a user's display name or email address.
  • Changing the domain associated with a user.
  • Updating the country code for compliance or localization purposes.

Properties

Name Meaning
Subscription ID The numeric ID of the Microsoft subscription under which the user exists.
User ID The unique identifier of the user to update.
User Data Collection of user information fields to update: Country (country code), Display Name, Domain, Email, First Name, Last Name. All are required.
Response Format The format in which the API response is returned. Options: JSON, XML.

Output

The node outputs the API response in the selected format (JSON or XML) inside the json field of the output data. For JSON responses, the output will be a parsed object representing the updated user data or status message from the API. If XML is selected, the raw XML string is returned under the data property.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Ikoula API, including an email, password, and optionally a custom API URL.
  • The password is encrypted using RSA public key encryption before being sent.
  • The node makes HTTP requests to the Ikoula Microsoft 365 API endpoints.
  • The user must configure the node with appropriate API credentials and ensure network access to the Ikoula API endpoint.

Troubleshooting

  • No credentials provided!: The node will throw an error if the required API credentials are missing. Ensure that the API key credential is configured correctly in n8n.
  • Invalid User ID or Subscription ID: Errors may occur if the provided IDs do not exist or are incorrect. Verify these values before running the node.
  • API response errors: If the API returns an error (e.g., due to invalid data or permissions), the node will either throw an error or return it in the output if "Continue On Fail" is enabled.
  • Network issues: Connectivity problems to the Ikoula API endpoint can cause request failures. Check network settings and firewall rules.
  • Incorrect response format: Selecting XML format returns raw XML strings; downstream nodes expecting JSON should use the JSON option.

Links and References

Discussion