HostBill

Overview

This n8n node interacts with the HostBill API to retrieve a list of domains associated with a specific client. The "Get Domains" operation under the "Client" resource is designed for scenarios where you need to programmatically fetch domain information for a given client, such as synchronizing domain data, generating reports, or integrating with other systems.

Practical examples:

• Automatically listing all domains owned by a particular client in your workflow.
• Fetching paginated domain data for auditing or migration purposes.
• Integrating domain information into custom dashboards or notification systems.

Properties

Output

The node outputs an array of JSON objects, each representing a domain associated with the specified client. The exact structure of each object depends on the HostBill API's response for the "Get Domains" operation, but typically includes fields such as domain name, status, registration date, and related metadata.

Example output:

[
  {
    "id": 123,
    "domain": "example.com",
    "status": "active",
    "registration_date": "2023-01-01",
    "...": "..."
  }
]

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.
• API Credentials: You must configure valid HostBill API credentials in n8n under the credential type hostBillApi.
• n8n Configuration: No additional 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, authentication errors will occur.
• Missing Required Property: Omitting the "Client ID" will result in an error, as it is mandatory.
• API Connection Errors: Network issues or incorrect HostBill API endpoint configuration can cause connection failures.

Error Messages:

• "Cannot read property '...' of undefined": Likely due to missing or misconfigured input properties.
• "HostBill API error: ...": Indicates an issue returned from the HostBill API itself (e.g., invalid client ID, insufficient permissions).
• "Error: ..." in output: When "Continue On Fail" is enabled, errors are included in the output array with an error field.

How to resolve:

• Double-check API credentials and permissions.
• Ensure the "Client ID" is provided and valid.
• Verify network connectivity to the HostBill API endpoint.

Links and References

• HostBill API Documentation
• n8n Documentation: Creating Custom Nodes
• n8n Credential Setup Guide