Hudu icon

Hudu

Interact with Hudu REST API

Overview

This node integrates with the Hudu REST API to manage various resources, including articles. Specifically, the Article Create operation allows users to create new articles within Hudu. This is useful for automating documentation workflows, content management, or knowledge base updates by programmatically adding articles.

Typical use cases include:

  • Automatically generating and publishing internal documentation from other systems.
  • Creating knowledge base articles based on external triggers or data inputs.
  • Associating articles with specific companies or folders for organized content management.
  • Enabling public sharing of articles via a public URL for non-authenticated users.

Properties

Name Meaning
Name The title or name of the article to be created.
Content The main body or content of the article.
Company Name or ID Associates the article with a specific company. You can select from a list of companies or specify an ID using an expression.
Enable Sharing Boolean flag indicating whether the article should have a public URL accessible to non-authenticated users.
Folder ID Numeric ID to associate the article with a specific folder for organizational purposes.

Output

The node outputs JSON data representing the newly created article object as returned by the Hudu API. This typically includes fields such as the article's unique identifier, name, content, associated company and folder IDs, sharing status, creation timestamps, and any other metadata provided by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the Hudu REST API.
  • Needs an API key credential configured in n8n for authentication.
  • The base URL for the Hudu instance must be set in the node credentials.
  • Option loaders are used to dynamically fetch lists of companies for selection.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication failures.
    • Providing an invalid company or folder ID may result in errors or the article not being properly associated.
    • Network connectivity issues to the Hudu API endpoint.
  • Error messages:

    • "The resource "articles" is not known!" — indicates the resource parameter was incorrect or missing.
    • API errors related to validation (e.g., missing required fields like Name) will be returned from the Hudu API and surfaced by the node.
  • Resolutions:

    • Ensure the API key and base URL are correctly configured in the node credentials.
    • Verify that required fields such as Name are provided.
    • Use the option loader dropdowns or valid expressions to specify existing company and folder IDs.
    • Check network access and firewall settings if connection errors occur.

Links and References

Discussion