Hudu icon

Hudu

Interact with Hudu REST API

Overview

This node interacts with the "lists" resource of the Hudu REST API, specifically supporting the Update operation on lists. It allows users to modify existing lists by changing their name and managing their list items—adding new items, updating existing ones, or removing them.

Common scenarios include:

  • Renaming a list to better reflect its contents.
  • Adding new entries to an existing list dynamically.
  • Updating details of specific list items.
  • Removing obsolete or incorrect list items from a list.

For example, a user might update a support ticket category list by renaming it and adding new categories while removing outdated ones, all within a single workflow execution.

Properties

Name Meaning
List ID The unique identifier of the list to update.
Update Fields Collection of fields to update on the list:
   Name New name for the list (string).
   List Items Array of list items to add, update, or remove. Each item supports:
      Add New Item (boolean) Whether to add a new list item (true) or update/delete an existing one (false).
      ID (number) ID of the existing list item (required if updating or deleting).
      Name (string) Name of the list item.
      Destroy (boolean) Whether to remove this list item (true to delete).

Output

The node outputs JSON data representing the updated list object as returned by the Hudu API after the update operation. This typically includes the list's current state with its updated name and list items.

No binary data output is involved.

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 API must be set in the node credentials.

Troubleshooting

  • Invalid List ID: If the provided List ID does not exist, the API will return an error. Verify the List ID is correct.
  • Missing Required Fields: The List ID is mandatory. Omitting it will cause the node to fail.
  • List Item ID Issues: When updating or deleting list items, ensure the item IDs are valid and belong to the specified list.
  • API Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Partial Updates: If multiple list items are updated/added/deleted simultaneously, errors in one item may affect the entire request depending on API behavior. Use "Continue On Fail" in n8n to handle such cases gracefully.

Links and References

Discussion