Ikoula Business APIInstall

Overview

This node integrates with the Ikoula Business API to manage various business operations related to subscriptions, services, domains, invoices, and terminations. Specifically, the "Cancel Termination" operation allows users to attempt stopping the termination process of a specific subscription account.

Common scenarios for this node include:

• Preventing an accidental or unwanted termination of a subscription.
• Managing subscription lifecycle events programmatically.
• Automating business workflows that require querying or modifying subscription and service states.

For example, if a customer requests to keep their service active after initiating termination, this node can be used to cancel that termination request via the API.

Properties

Output

The node outputs the API response in the specified format (json or xml) under the json property of the output data. The structure depends on the API's response but generally contains information about the success or failure of the cancellation request.

If the response format is JSON, the output will be parsed into a JavaScript object. If XML is chosen, the raw XML string is returned as a string inside the data field.

No binary data output is produced by this operation.

Dependencies

• Requires valid credentials for the Ikoula Business 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 GET or POST requests to the Ikoula API endpoints.
• The user must configure the node with appropriate API credentials (email and password).
• No additional environment variables are required beyond the credential setup.

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without proper API credentials configured. Ensure that the API authentication details are set up correctly in the node credentials.

• API request failures
  Network issues, invalid subscription IDs, or incorrect parameters may cause the API to return errors. Verify that the subscription ID exists and that the API endpoint is reachable.

• Response format issues
  Selecting XML format returns raw XML strings; downstream nodes expecting JSON may fail. Choose JSON format unless XML is specifically needed.

• Encryption errors
  The password is encrypted with a hardcoded RSA public key. If the API changes its key or encryption method, the node will fail to authenticate.

Links and References

• Ikoula Business API Documentation (general reference for API endpoints and parameters)
• n8n HTTP Request Node Documentation (for understanding how HTTP requests are made within n8n)

If you need details on other operations or resources, feel free to ask!