This community node enables seamless integration with the Hudu documentation platform in your n8n workflows, allowing you to automate and manage your IT documentation tasks.
API Compatibility: This node is aligned with Hudu API version 2.37.0. Some features require specific API versions. Compatibility with future Hudu versions is not guaranteed without further updates.
- Magic Dash:
- The
Getoperation now correctly retrieves an item even if it is not on the first page of results. - Removed the non-standard
delete by titleoperation in favour of the standarddelete by ID.
- The
- Assets:
- The
Get Manyoperation now supports fetching assets across all companies by making theCompany IDfield optional. When theCompany IDis omitted, a wider range of filters becomes available.
- The
- Asset Layouts:
- Aligned the
updateoperation with the Hudu API, which now correctly accepts an array of field names for reordering.
- Aligned the
- Asset Layout Fields:
- The
linkable_idfield now uses a dynamic asset layout picker, improving UX forAsset LinkandAsset Tagfields.
- The
- Asset Layouts:
- Removed the
activefield from thecreateoperation, as it is only supported for updates. - Corrected the
updateoperation to no longer show a UI for creating new fields, which was misaligned with the API's reordering functionality.
- Removed the
- Asset Layout Fields:
- Fixed a parameter dependency loop that caused the UI to crash.
- Refactored handler logic to use dedicated API endpoints for
create,update, anddeleteoperations, improving efficiency and reliability.
- Major: Enhanced
AssetsandAsset Layoutsresources to fully support all API operations, improving functionality and resolving previous inconsistencies. - Changed: Reverted the separation of asset field management. Operations for standard, custom, and link fields are now handled directly within the
Assetresource'supdateoperation via the unified resource mapper. - Fix: Corrected an issue with the Asset Layout update operation that was causing a 500 Internal Server Error.
- The
ListsandList Optionsresources are now managed as separate, distinct resources, each with their own full set of CRUD operations for improved clarity and flexibility. This change allows you to manage lists themselves and the items within those lists independently. - Public Photos resource improvements:
- Filter fields (
Record Type FilterandRecord ID Filter) are now grouped in a single optional "Filter" fixed collection for the Get Many operation, improving UI consistency and usability. - The Get by ID operation now fetches public photos page by page, checking each page for the requested ID and returning as soon as it is found. This is much more efficient for large datasets.
- Documentation and type definitions for Public Photos have been updated for clarity and alignment with the API.
- Filter fields (
Note: Some features in this version require Hudu API v2.37.0 to function properly.
(For full change history, see CHANGELOG.md)
Follow the installation guide in the n8n community nodes documentation.
To use this node, you need to:
- Have a Hudu instance
- Generate an API key in your Hudu settings
- Configure the node with:
- Base URL (e.g., https://your-hudu-instance.com)
- API Key
- Comprehensive pagination support for all applicable resources
- Robust error handling and debugging capabilities
- Advanced filtering options with both API-side and client-side filtering
- Support for both single and bulk operations
- Dynamic loading of related resources (companies, layouts, etc.)
- Date range filtering with preset options
- Automatic type conversion and validation
- Debug logging for troubleshooting
- Full CRUD support for VLANs and VLAN Zones
- Websites resource now supports all fields, including new email security options
- Get all activity logs with filtering support
- Filter by user, action, and date range
- Get API information and version details
- Create, update, archive, unarchive, delete, and retrieve articles
- List all articles with comprehensive filtering (company, draft, sharing, folder, name, fuzzy search, updated date range)
- Get article version history
- Manage core asset lifecycle & properties: Create, retrieve, update core details, archive, unarchive, move layout, and delete assets
- Link assets to companies
- Get single asset details, including all its field values
- List all assets with enhanced filtering (e.g., by company, update date, archived status)
- Create and manage asset layout templates
- Get layout fields and configurations
- List all layouts with filtering support
- Advanced custom field support: Add hints, min/max, linkable asset layout IDs, expiration, options, and more to your custom fields. Use the "Other Data" input to specify any additional API-supported properties
- Create and manage asset-related passwords
- Link passwords to assets and companies
- Filter by company and resource types
- Lookup cards by integration
- Jump to card functionality
- Filter by integration type and slug
- Create, update, delete, and retrieve companies
- List all companies with filtering support
- Jump to company by integration
- Get all expirations with comprehensive filtering (company, expiration type, resource ID/type, date ranges)
- Create and manage document folders
- Support for nested folder structures
- Filter by parent folder
- Track child folder status
- Track and manage IP addresses
- Link to companies and networks
- Filter by company and network
- Create, update, retrieve, and delete lists
- Use this resource to manage the lists themselves
- Filter lists by name or query
- Create, update, retrieve, and delete list items within a specific list
- Use this resource to manage the items/options of a list
- Create, update, get, and delete Magic Dash items
- List all items with filtering by company and title
- Configure and manage integration matchers
- Filter by match status and company
- Support for sync identifiers
- Create and manage network information
- Link to companies
- Filter by company and attributes
- Create and organise password folders
- Support for folder hierarchy
- Filter by parent folder
- Create and manage procedures
- Create from templates
- Duplicate existing procedures
- Manage procedure tasks
- Track task completion
- Create and manage resource relationships
- Support for various resource types
- Filter by relationship types and directions
- Get user information
- List all users
- Filter by role and status
- Full CRUD support for VLANs, including filtering by company, name, and VLAN ID
- Full CRUD support for VLAN Zones, including filtering by company, name, archive status, and date ranges
- Manage file uploads
- Manage website records
- Link to companies
- Filter by company and status
- All fields supported, including new email security fields:
enable_dmarc_tracking,enable_dkim_tracking,enable_spf_tracking, and more
Contributions are welcome! If you'd like to contribute to this project:
- Fork the repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Please ensure your PR:
- Clearly describes the changes
- Includes any relevant documentation updates
- Follows the existing code style
- Includes tests if applicable
For bug reports or feature requests, please use the GitHub issues section.
If you find this node helpful and would like to support its development:
