HostBill

Overview

This n8n node allows you to interact with the HostBill API, specifically targeting the "Domain" resource and its "Epp" operation. The node is designed to retrieve EPP (Extensible Provisioning Protocol) information for a specific domain by its ID. This can be useful in scenarios where you need to automate domain management tasks, such as fetching EPP codes for domain transfers or verifying domain ownership within automated workflows.

Practical examples:

• Automating the retrieval of EPP codes for domains managed in HostBill.
• Integrating domain transfer processes into larger automation pipelines.
• Verifying domain details before performing further actions like renewals or updates.

Properties

Output

The output will be a JSON object (or an array of objects if multiple items are processed). The structure of the output json field will contain the EPP information for the specified domain. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example output:

[
  {
    "eppCode": "example-epp-code",
    "domainId": 12345,
    // ...other relevant fields returned by the HostBill API
  }
]

If an error occurs:

[
  {
    "error": "Domain not found"
  }
]

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 name hostBillApi.
• n8n Configuration: No additional environment variables are required beyond standard credential setup.

Troubleshooting

Common issues:

• Invalid Domain ID: If the provided Domain ID does not exist, the node will return an error message such as "Domain not found".
• Authentication Failure: If the HostBill API credentials are incorrect or missing, the node will throw an authentication error.
• API Connectivity Issues: Network problems or incorrect HostBill API endpoint configuration may result in connection errors.

Error messages and resolutions:

• "Domain not found": Check that the Domain ID is correct and exists in your HostBill system.
• "Authentication failed": Verify your HostBill API credentials in n8n.
• "Network error": Ensure your n8n instance can reach the HostBill API endpoint.

Links and References

• HostBill API Documentation
• n8n Documentation: Creating Custom Nodes
• EPP (Extensible Provisioning Protocol) Overview