HostBill icon

HostBill

Consume HostBill API (v.0.1.3)

Overview

This n8n custom node integrates with the HostBill API, specifically enabling the creation of an "Account" resource. The node is designed to automate account creation tasks within workflows, making it useful for scenarios such as onboarding new users, synchronizing account data between systems, or automating provisioning processes in hosting and billing environments.

Practical examples:

  • Automatically create a new customer account in HostBill when a user signs up on your website.
  • Batch-create accounts from a CSV import using n8n's workflow automation.
  • Integrate with other systems (e.g., CRM, ERP) to keep account records synchronized.

Properties

Name Type Meaning
Account ID Number The unique identifier for the account to be created. This is required.

Output

The node outputs a JSON object (or array of objects if processing multiple items). The structure of the output json field will reflect the response from the HostBill API for the "Create Account" operation. Typical fields may include details about the newly created account, such as its ID, status, and any additional metadata returned by the API.

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Dependencies

  • External Service: Requires access to a HostBill instance with API enabled.
  • API Credentials: Needs valid HostBill API credentials configured in n8n under the name hostBillApi.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the provided HostBill API credentials are incorrect or lack necessary permissions, the node will throw an authentication error.
  • Missing Required Fields: If "Account ID" is not provided, the node will fail to execute.
  • API Errors: Any errors returned by the HostBill API (such as duplicate account IDs or validation failures) will be surfaced as node errors.

Error Messages:

  • "Cannot read property 'execute' of undefined": Likely due to misconfiguration or missing dependencies.
  • "Missing required parameter: Account ID": Ensure all required properties are set.
  • "Authentication failed": Check that the HostBill API credentials are correct and active.

How to resolve:

  • Double-check API credentials in n8n.
  • Ensure all required input properties are filled.
  • Review HostBill API documentation for specific requirements or limitations.

Links and References

Discussion