n8n-nodes-hudu

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.39.6. Some features require specific API versions. Compatibility with future Hudu versions is not guaranteed without further updates.

Installation

Follow the installation guide in the n8n community nodes documentation.

Credentials

To use this node, you need to:

1. Have a Hudu instance
2. Generate an API key in your Hudu settings
3. Configure the node with:
   • Base URL (e.g., https://your-hudu-instance.com)
   • API Key

Features

• Comprehensive pagination support for 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, users, assets, layouts, networks, groups, VLANs, VLAN Zones)
• Date range filtering with preset options
• Automatic type conversion and validation
• Debug logging for troubleshooting
• Central request sanitisation (omits empty optionals to prevent API 500s)
• Resource-specific update collections across all resources
• Optional article markdown conversion (HTML to Markdown) for Articles get/get many
• Flexible identifier support: Get operations support both numeric IDs and slugs via Identifier Type toggle (Articles, Asset Layouts, Asset Passwords, Assets, Companies, Groups, Networks, Password Folders, Procedures, Users, VLAN Zones, VLANs, Websites)

Supported Resources & Operations

Activity Logs

• Get all activity logs with comprehensive filtering support
• Filter by user (ID or email), action, resource (ID and type), and date range
• Delete activity logs by datetime with optional unassigned logs filter

API Info

• Get API information and version details

Articles

• Create, update, archive, unarchive, delete, and retrieve articles
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• List all articles with comprehensive filtering (company, draft, sharing, folder, name, fuzzy search, updated date range)
• Get article version history
• Include Markdown Content toggle to return markdown_content alongside original HTML

Asset

• Manage core asset lifecycle & properties: Create, retrieve, update core details, archive, unarchive, move layout, and delete assets
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• 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)

Asset Layouts

• Create and manage asset layout templates
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• 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

Asset Passwords

• Create and manage asset-related passwords
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Link passwords to assets and companies
• Filter by company and resource types

Cards

• Lookup cards by integration (supports integration ID or identifier)
• Jump to card by integration ID or identifier
• Filter by integration type and slug

Companies

• Create, update, delete, and retrieve companies
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• List all companies with filtering support
• Jump to company by integration

Expirations

• Get all expirations with comprehensive filtering (company, expiration type, resource ID/type, date ranges)

Folders

• Create and manage document folders
• Support for nested folder structures
• Filter by parent folder
• Track child folder status

IP Addresses

• Track and manage IP addresses
• Link to companies and networks
• Filter by company and network

Lists

• Create, update, retrieve, and delete lists
• Use this resource to manage the lists themselves
• Create list items when creating a list, or add/update/remove items when updating a list
• Filter lists by name or query

List Options

• Create, update, retrieve, and delete list items within a specific list
• Use this resource to manage the items/options of a list

Magic Dash

• Create, update, get, and delete Magic Dash items
• List all items with filtering by company and title
• Delete by ID or by title + company name

Matchers

• Configure and manage integration matchers
• Filter by match status and company
• Support for sync identifiers

Networks

• Create and manage network information
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Link to companies
• Filter by company and attributes
• Pick related VLANs with an option loader

Password Folders

• Create, update, delete, and retrieve password folders
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Security modes: all users or specific groups (allowed_groups when security = specific)
• Filter by name, company, search
• Pick allowed groups with an option loader

Exports

• Initiate company exports with format options: PDF, CSV, or S3
• Optional inclusions: websites, passwords, and specific asset layouts

S3 Exports

• Initiate S3 exports (uses credentials configured in Hudu account settings)

Procedures

• Create and manage procedures
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Create from templates
• Duplicate existing procedures
• Manage procedure tasks
• Track task completion

Relations

• Create and manage resource relationships
• Support for various resource types
• Filter by relationship types and directions

Groups

• Retrieve groups and retrieve a group by ID
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Filters: name, default, search; supports pagination

Users

• Get user information
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• List all users
• Filter by role and status

VLANs

• Full CRUD support for VLANs, including filtering by company, name, and VLAN ID
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Pick VLAN Zone and Status List via option loaders

VLAN Zones

• Full CRUD support for VLAN Zones, including filtering by company, name, archive status, and date ranges
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• Option loader available for selecting zones where referenced

Uploads

• Manage file uploads
• Operations: Create (multipart upload), Get, Get Many, Delete

Websites

• Manage website records
• Get operation supports numeric ID or slug selection via Identifier Type toggle
• 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

Resources

• n8n community nodes documentation
• Hudu API Documentation
• GitHub Repository

Contributing

Contributions are welcome! If you'd like to contribute to this project:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. 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.

Support

If you find this node helpful and would like to support its development:

License

MIT