AvantGuard - HuduInstall

Overview

The AvantGuard - Hudu node for n8n allows users to create (POST) new website records in the Hudu system. This is particularly useful for automating the onboarding of new websites, associating them with companies, and configuring monitoring options such as DNS, SSL, and WHOIS checks. Common scenarios include:

• Automatically adding client websites when a new customer is onboarded.
• Bulk importing websites from another system.
• Programmatically pausing or customizing monitoring for specific sites.

Example use case:
When a new company signs up, this node can be used to register their website in Hudu, associate it with their company record, and configure which types of monitoring should be enabled or disabled.

Properties

Name	Type	Meaning
Company Id	Number	Used to associate the website with a specific company in Hudu.
Name	String	The name or URL of the website being added.
Notes	String	Additional notes or comments about the website.
Paused	Boolean	If true, website monitoring is paused.
Disable Dns	Boolean	If true, DNS monitoring for the website is paused.
Disable Ssl	Boolean	If true, SSL certificate monitoring for the website is paused.
Disable Whois	Boolean	If true, WHOIS monitoring for the website is paused.

All these properties are optional and can be provided via the "Additional Body Fields" collection.

Output

The node returns a JSON object representing the newly created website record in Hudu. The structure typically includes fields such as:

{
  "id": 123,
  "company_id": 456,
  "name": "example.com",
  "notes": "Some notes",
  "paused": false,
  "disable_dns": false,
  "disable_ssl": false,
  "disable_whois": false,
  // ...other metadata fields returned by the Hudu API
}

• The exact output fields depend on the Hudu API's response for website creation.
• No binary data is produced by this node.

Dependencies

• External Service: Requires access to a Hudu instance with API enabled.
• API Key/Credentials: Needs valid avantguardHuduApi credentials configured in n8n, including the base URL and authentication token.
• n8n Configuration: Ensure the credentials are set up under the name avantguardHuduApi.

Troubleshooting

Common Issues:

• Invalid Credentials:
  Error message: "401 Unauthorized" or similar.
  Resolution: Check that your API key and base URL are correct in the n8n credentials.

• Missing Required Fields:
  Error message: "400 Bad Request" or similar.
  Resolution: Ensure you provide at least the required fields expected by your Hudu instance (e.g., "Name" or "Company Id" if enforced).

• Connection Errors:
  Error message: "ENOTFOUND", "ECONNREFUSED", etc.
  Resolution: Verify network connectivity to your Hudu server and that the base URL is correct.

• Permission Denied:
  Error message: "403 Forbidden".
  Resolution: Make sure the API user has permission to create websites in Hudu.

Links and References

• Hudu API Documentation
• n8n Documentation: Creating Custom Nodes
• AvantGuard GitHub