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

# Hudu

> Connect Hudu to Triggr with a Hudu API key.

Triggr works with Hudu companies, assets, passwords, articles, processes, networks and Magic Dash. In Triggr's action names, passwords are Asset Passwords, processes are Procedures and knowledge base articles are Articles.

## Set up Hudu

You need the Admin or Super Admin role in Hudu.

<Steps>
  <Step title="Create an API key">
    In Hudu's admin area, go to **Account Administration > API Keys**, click **+ New API Key** and name it `Triggr`.
  </Step>

  <Step title="Set its scope">
    You can't change these settings after you create the key.

    * Limit scope to: Full access.
    * Company: leave empty, so one key covers all your clients.
    * Allowed IP Addresses: leave blank, or enter [Triggr's IP addresses](/security/ip-allowlist), one per line.
    * Under Key can perform the following actions, tick View passwords, Delete data or Export data if your workflows use password, delete or export actions.
  </Step>

  <Step title="Copy the key">
    Click **Create** and copy the key straight away. Hudu hides it after five minutes.
  </Step>
</Steps>

If IP Access Control is on (Admin > Security > IP Access Control), it applies to API requests too: add [Triggr's IP addresses](/security/ip-allowlist) there. See Hudu's [REST API](https://support.hudu.com/hc/en-us/articles/11422780787735-REST-API) and [IP Access Control](https://support.hudu.com/hc/en-us/articles/17841907880855-IP-Access-Control) articles.

## Connect it in Triggr

<Steps>
  <Step title="Open the integration">
    Go to **Integrations > Hudu** and click Configure on the Base Configuration card.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/base-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=bb81acb082055015f91beda7b4876f35" alt="The Base Configuration card with Status Not Configured, Admin Consent Not Required and a Configure button." width="2272" height="330" data-path="images/integrations-common/base-configuration.png" />
    </Frame>
  </Step>

  <Step title="Enter the key and address">
    Paste the key into apiKey, enter the address you sign in to Hudu with as baseUrl, such as `https://yourcompany.huducloud.com` (without `/api/v1`), and click Save Configuration.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/hudu/configure.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=8e7b63040eee0672fba3f4c533306423" alt="The Hudu configuration window with apiKey and baseUrl fields, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="1126" data-path="images/hudu/configure.png" />
    </Frame>
  </Step>
</Steps>

Actions on one company take its Hudu company ID, which Retrieve a list of companies returns. Create and update actions take a JSON body using the field names in Hudu's API documentation (Admin > API Keys > View the API Documentation).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication fails">
    Check apiKey holds the full key with no spaces. If you copied it after Hudu hid it, you copied the masked value: create a new key.
  </Accordion>

  <Accordion title="Every action fails or returns not found">
    baseUrl must start with `https://` and have nothing after the domain.
  </Accordion>

  <Accordion title="Requests are blocked by IP address">
    Add [Triggr's IP addresses](/security/ip-allowlist) to IP Access Control. A key's Allowed IP Addresses can't be edited, so create a new key if they're missing.
  </Accordion>

  <Accordion title="Hudu is self-hosted">
    Publish it at a public address and allow [Triggr's IP addresses](/security/ip-allowlist) through your firewall. If it uses a self-signed certificate, turn on Advanced > Allow insecure TLS in the configuration window.
  </Accordion>

  <Accordion title="Password, delete or export actions fail, or companies are missing">
    The key was created without View passwords, Delete data or Export data, or with a Company selected. Create a new key with the right settings.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.