Hudu

Overview

The Hudu integration lets Bumblebee workflows read documentation from your Hudu instance. It is useful for pulling internal runbooks and knowledge base articles into automated workflows.

Prerequisites & Setup

Before setting up the Hudu integration, you need:

• A Hudu instance with API access enabled
• A Hudu API key with permission to read articles
• Your Hudu domain URL (for example, https://your-instance.huducloud.com)

Create an API Key in Hudu

1. Log in to your Hudu admin account
2. Navigate to Admin > API Keys
3. Create a new API key for Bumblebee
4. Copy and store the key securely
5. Confirm your key has access to the data you want to query

Configure in Bumblebee

1. Go to the Integrations page in Bumblebee
2. Select Hudu
3. Enter:
   • API Key
   • API Domain (your Hudu base URL)
4. Click Test Connection
5. Save the configuration

Available Tools

Companies

• list_companies - List companies in Hudu with optional filters. Optional: name (str), id_in_integration (int), page (int), page_size (int)
• get_company - Get a specific company by ID from Hudu. Required: company_id (int)
• create_company - Create a new company in Hudu. Required: name (str). Optional: nickname (str), company_type (str), address_line_1 (str), address_line_2 (str), city (str), state (str), zip (str), country_name (str), phone_number (str), fax_number (str), website (str), notes (str)
• update_company - Update an existing company in Hudu. Required: company_id (int). Optional: name (str), nickname (str), company_type (str), address_line_1 (str), address_line_2 (str), city (str), state (str), zip (str), country_name (str), phone_number (str), fax_number (str), website (str), notes (str)

Assets

• list_assets - List assets in Hudu with optional filters. Optional: company_id (int), name (str), asset_layout_id (int), page (int), page_size (int)
• get_asset - Get a specific asset by ID from Hudu. Required: asset_id (int), company_id (int)
• create_asset - Create a new asset in Hudu under a specific company. Required: company_id (int), asset_layout_id (int), name (str). Optional: custom_fields (List[Dict[str, Any]])
• update_asset - Update an existing asset in Hudu. Required: asset_id (int), company_id (int). Optional: name (str), asset_layout_id (int), custom_fields (List[Dict[str, Any]])

Asset Layouts

• list_asset_layouts - List asset layouts (templates) in Hudu. Optional: name (str), page (int), page_size (int)
• get_asset_layout - Get a specific asset layout by ID from Hudu. Required: asset_layout_id (int)

Articles

• list_articles - List knowledge base articles in Hudu with optional filters. Optional: company_id (int), name (str), page (int), page_size (int)
• get_article - Get a specific knowledge base article by ID from Hudu. Required: article_id (int)
• create_article - Create a new knowledge base article in Hudu. Required: company_id (int), name (str), content (str). Optional: folder_id (int)
• update_article - Update an existing knowledge base article in Hudu. Required: article_id (int). Optional: name (str), content (str), folder_id (int)

Passwords

• list_passwords - List password entries in Hudu with optional filters. Optional: company_id (int), name (str), page (int), page_size (int)
• get_password - Get a specific password entry by ID from Hudu. Required: password_id (int)

Folders

• list_folders - List folders in Hudu with optional filters. Optional: company_id (int), name (str), page (int), page_size (int)
• get_folder - Get a specific folder by ID from Hudu. Required: folder_id (int)

Websites

• list_websites - List websites in Hudu with optional filters. Optional: company_id (int), name (str), page (int), page_size (int)
• get_website - Get a specific website by ID from Hudu. Required: website_id (int)

Procedures

• list_procedures - List procedures (checklists) in Hudu with optional filters. Optional: company_id (int), name (str), page (int), page_size (int)
• get_procedure - Get a specific procedure by ID from Hudu. Required: procedure_id (int)

Expirations

• list_expirations - List expirations in Hudu with optional filters. Optional: company_id (int), resource_type (str), page (int), page_size (int)

Relations

• list_relations - List all relations between objects in Hudu. Optional: page (int), page_size (int)
• create_relation - Create a new relation between two objects in Hudu. Required: fromable_type (str), fromable_id (int), toable_type (str), toable_id (int). Optional: description (str), is_inverse (str)

Activity Logs

• list_activity_logs - List activity logs in Hudu with optional filters. Optional: user_id (int), user_email (str), resource_id (int), resource_type (str), action_message (str), start_date (str), page (int), page_size (int)