> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Hudu Documentation to Super Magic

> Connect Hudu to Thread so Super Magic can search your IT documentation alongside the Thread knowledge base and surface relevant articles for technicians.

## Hudu Integration Guide

The Hudu integration connects your Thread environment directly to your Hudu documentation platform. This integration enables Thread’s AI, "Super Magic," to access, read, and reference your Hudu knowledge base articles alongside Thread's internal knowledge base.

Currently, this integration functions by searching your Hudu instance globally to retrieve relevant information for technicians.

Super Magic searches your Hudu documentation and Thread's internal knowledge base simultaneously, so technicians get answers from both sources without leaving their workflow.

## How To: Set Up the Hudu Integration

**Prerequisites**

* Admin access to your Thread dashboard.
* Admin access to your Hudu instance to generate API keys.

<Steps>
  <Step title="Generate an API Key in Hudu">
    1. Log in to your Hudu instance.
    2. Navigate to **Admin** > **API Keys**.
    3. Click **New API Key**.
    4. Name the key (e.g., "Thread Integration") to identify it later.
    5. Copy the API Key.
  </Step>

  <Step title="Configure the Integration in Thread">
    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/f3a625bb-screenshot-2025-12-29-at-4-08-02-pm.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=9f891c6014232aa4d005b014103cff51" alt="Hudu integration configuration in the Thread Admin dashboard" width="2678" height="1528" data-path="images/f3a625bb-screenshot-2025-12-29-at-4-08-02-pm.png" />
    </Frame>

    1. Log in to the Thread Admin dashboard.
    2. Navigate to the **Integrations** panel.
    3. Locate and select the **Hudu** integration.
    4. Enter your Hudu **Base URL**.
    5. Paste the **API Key** you generated in Step 1.

    <Frame>
      <img src="https://mintcdn.com/thread/MmA6qEMELRi-vXeU/images/c69e8405-screenshot-2025-12-29-at-4-08-20-pm.png?fit=max&auto=format&n=MmA6qEMELRi-vXeU&q=85&s=5202a58076792ee71f27d7868abca646" alt="Entering the Hudu Base URL and API Key in Thread" width="2676" height="1466" data-path="images/c69e8405-screenshot-2025-12-29-at-4-08-20-pm.png" />
    </Frame>

    6. Click **Save** to complete the configuration.
  </Step>

  <Step title="Verification">
    Once saved, the integration is immediately active. You can test this by opening a thread (in Slack or Teams) and using "Super Magic" to ask a question related to an article stored in Hudu. The AI should be able to retrieve the information and provide a link to the source article.
  </Step>
</Steps>

## Important Notes

* **Company Mapping:** Currently, the integration searches Hudu globally. It does not yet strictly map specific Hudu companies to specific Thread companies, though dynamic mapping is being explored for future updates.
* **Release Scope:** For the current release, Super Magic will pull answers from Hudu, but the user interface may not explicitly distinguish between a "Thread article" and a "Hudu article" until the user clicks the source link.


## Related topics

- [Use Hudu with Super Magic](/super-magic/use-hudu-with-super-magic.md)
- [Connect Knowledge Sources to Super Magic](/super-magic/connect-it-glue-hudu-time-zest-knowledge-sources-to-super-magic.md)
- [Connect IT Glue Documentation to Super Magic](/integrations/it-glue-super-magic.md)