HostBill icon

HostBill

Consume HostBill API (v.0.1.3)

Overview

The HostBill node for n8n allows you to interact with the HostBill API, specifically to retrieve a list of domains using the "Get All" operation under the "Domain" resource. This is useful for automating workflows that require fetching domain information from your HostBill account, such as reporting, monitoring domain status, or integrating with other systems.

Practical examples:

  • Retrieve all domains to generate a report of active and expired domains.
  • List domains for further processing, such as sending renewal reminders.
  • Integrate domain data into other business processes or dashboards.

Properties

Name Type Meaning
Additional Fields Collection A group of optional parameters to refine the domain listing. See below for details.

Additional Fields options:

Name Type Meaning
Page Number Which page of results to return (for pagination).
Status to List Options Filter domains by their status. Possible values: All, Active, Expired, Pending, Pending Transfer, Pending Registration.

Output

The node outputs an array of JSON objects, each representing a domain retrieved from HostBill. The exact structure of each object depends on the HostBill API response, but typically includes fields such as domain name, status, expiration date, and other relevant domain details.

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

Dependencies

  • External Service: Requires access to a HostBill instance with API enabled.
  • Credentials: You must configure the hostBillApi credentials in n8n.
  • Environment: No special environment variables are required beyond standard n8n credential configuration.

Troubleshooting

Common issues:

  • Invalid Credentials: If the provided HostBill API credentials are incorrect, authentication will fail. Ensure your API key and URL are correct.
  • API Connection Errors: Network issues or incorrect HostBill API endpoint URLs can cause connection failures.
  • Permission Issues: The API user may lack permissions to list domains.

Error messages:

  • "Cannot read property ..." or similar: Indicates a problem with the API response or parameter mapping. Check your input parameters.
  • "Error: <message>" in output: If "Continue On Fail" is enabled, errors are returned in the output array. Review the error message for clues.

Links and References

Discussion