Hudu icon

Hudu

Interact with Hudu REST API

Overview

This node integrates with the Magic Dash feature of the Hudu platform, allowing users to create new Magic Dash items programmatically. Magic Dash items are customizable dashboard elements that can display messages, rich HTML content, images, icons, and links associated with a specific company.

Typical use cases include:

  • Automatically adding informational or alert messages to a company's Magic Dash in response to events.
  • Populating dashboards with dynamic content such as status updates, embedded media, or links.
  • Enhancing company profiles with visual and textual data for internal teams.

For example, you could create a Magic Dash item that displays a welcome message with an image and a link to a related resource whenever a new company is onboarded.

Properties

Name Meaning
Message The primary text content displayed on the Magic Dash item.
Company Name The name of the company to which this Magic Dash item belongs; used to associate the item with the correct company.
Title The title of the Magic Dash item; used to identify and match existing items with the same title and company.
Content Rich HTML content (such as tables, images, videos) to be shown inside the Magic Dash item.
Additional Fields Optional extra fields to customize the Magic Dash item:
Company Name or ID: Select or specify the company by name or ID.
Content Link: URL linking to an external website related to the content.
Icon: Font Awesome icon code (e.g., fa-home).
Image URL: URL of an image to display in the header.
Shade: Color shade for styling the item.

Output

The node outputs JSON data representing the created Magic Dash item(s). Each output item corresponds to one Magic Dash entry created or updated, including all relevant fields returned from the API.

If the operation fails for any input item and "Continue On Fail" is enabled, the output will contain error information for that item instead.

No binary data is produced by this node.

Dependencies

  • Requires an active connection to the Hudu REST API with a valid API key credential.
  • The base URL and API key must be configured in the node's credentials.
  • Uses the Hudu API endpoints related to Magic Dash items.
  • Optionally loads companies dynamically for selection via an internal method.

Troubleshooting

  • Common issues:

    • Incorrect or missing company name may cause the API to fail matching the Magic Dash item to a company.
    • Invalid HTML content or unsupported icons might not render correctly in the Magic Dash UI.
    • Network or authentication errors if API key or base URL are misconfigured.
  • Error messages:

    • "The resource "magic_dash" is not known!" — indicates the resource parameter was incorrect or missing.
    • API errors returned from Hudu will be passed through; check the message for details like invalid fields or permission issues.
  • Resolutions:

    • Verify company names exactly match those in Hudu or use company IDs where possible.
    • Ensure the API key credential has sufficient permissions.
    • Validate HTML content and URLs before sending.

Links and References

Discussion