> ## 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.

# UniFi Site Manager

> Connect a UI account to Triggr with a Site Manager API key to monitor UniFi consoles, sites and devices from the cloud.

Triggr reads the hosts (consoles), sites, devices and ISP metrics on a UI account. Every action reads data: to make a change on a console, use [UniFi Network](/integrations/unifi/network), which takes the same key and the host `id` from List Hosts as its Console ID (remote).

## Create a Site Manager API key

Sign in to [unifi.ui.com](https://unifi.ui.com), go to **Settings → API Keys**, select **Create New API Key** and copy the key. Ubiquiti shows it only once, and the key sees what its UI account or organisation sees. See Ubiquiti's [Site Manager getting started guide](https://developer.ui.com/site-manager/v1.0.0/gettingstarted).

## Connect it in Triggr

<Steps>
  <Step title="Open the configuration">
    Go to **Integrations > UniFi Site Manager** 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">
    Paste the key into API Key and click Save Configuration.

    <Frame>
      <img src="https://mintcdn.com/triggr/rFRD51HB_88hTzdJ/images/unifi-site-manager/configure.png?fit=max&auto=format&n=rFRD51HB_88hTzdJ&q=85&s=c46bf021a6396fd1964e645acf095c8e" alt="The UniFi Site Manager configuration window with an API Key field, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="898" data-path="images/unifi-site-manager/configure.png" />
    </Frame>
  </Step>
</Steps>

## Set up each client

Per-client integrations never fall back to the Base Configuration, so click **Configure** on each client's row and paste a key into API Key: one from the client's own UI account, or from yours if their consoles sit under it (in which case it also returns your other clients' consoles).

<Frame>
  <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/per-client-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=11464b4946bea0b580c73330d9114a41" alt="The Per-Client Configuration card listing Acme Corp and Globex, each Not Configured with Admin Consent Not Required and a Configure button." width="2272" height="646" data-path="images/integrations-common/per-client-configuration.png" />
</Frame>

## Use the actions

* Get Host takes the `id` from List Hosts, including the colon and digits at the end.
* Get ISP Metrics takes a `type` of `5m` or `1h`. Ubiquiti keeps 5-minute metrics for at least 24 hours and 1-hour metrics for at least 30 days.

## Troubleshooting

<AccordionGroup>
  <Accordion title="401 errors">
    Check the key is complete, still exists under Settings → API Keys, and comes from unifi.ui.com, not a console's UniFi Network application.
  </Accordion>

  <Accordion title="no UniFi Site Manager integration is configured for this client">
    Configure the client on the Per-Client Configuration card.
  </Accordion>

  <Accordion title="Hosts, sites or devices are missing">
    The key returns only consoles linked to its account. List Sites covers only hosts running the UniFi Network application, and List Devices only hosts where the account is the owner or a super admin.
  </Accordion>

  <Accordion title="Rate limits (429)">
    Spread a large workflow's requests out or run it in smaller batches.
  </Accordion>
</AccordionGroup>


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