Hudu icon

Hudu

Interact with Hudu REST API

Actions100

Overview

This node integrates with the Hudu REST API to manage various resources within Hudu, a documentation and asset management platform. Specifically, for the List - Create operation, it allows users to create a new list along with multiple list items in one action. This is useful for organizing information or assets into categorized lists directly from an automation workflow.

Practical examples include:

  • Automatically creating a checklist or inventory list when a new project starts.
  • Generating a task list with predefined items for onboarding processes.
  • Creating categorized asset lists for IT documentation purposes.

Properties

Name Meaning
Name The name of the list to be created.
List Items An array of list items to add to the newly created list. Each item requires a "Name".

The List Items property supports adding multiple entries, each with a required "Name" field representing the individual list item's name.

Output

The node outputs a JSON array where each element corresponds to the created list resource including its details as returned by the Hudu API. Each output item is paired with the input item index it originated from.

The output JSON typically includes:

  • The unique identifier of the created list.
  • The list's name.
  • Details of the included list items.
  • Any other metadata provided by the Hudu API response for the list creation.

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 credentials.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication failures.
    • Providing empty or invalid list names or list item names may result in API errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "The resource "lists" is not known!" — indicates the resource parameter was incorrect or missing.
    • API error responses related to validation (e.g., missing required fields) should be checked and corrected in the input properties.

  • Resolution tips:

    • Ensure the API key and base URL are correctly configured.
    • Validate that all required fields ("Name" for list and list items) are provided.
    • Use the node’s continue-on-fail option to handle partial failures gracefully.

Links and References

Discussion