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

# Domotz

> Connect Domotz to Triggr with a Full Access Public API key and your account's API endpoint host.

Triggr works with Domotz collectors, devices, monitoring data, alerts, power actions and Access Management users. You need the Domotz account owner, or a user whose role includes the API Keys permission, such as Administrator (see Domotz's [Role Based Access Control](https://help.domotz.com/admin-global-features/role-based-access-control-rbac/) guide).

## Set up Domotz

<Steps>
  <Step title="Create a Full Access key">
    In the [Domotz Portal](https://portal.domotz.com/), go to **Settings > API Keys** and click Create an API Key, not Create a Collector Activation Key. Enter your password, click Unlock, name the key and click Create.
  </Step>

  <Step title="Copy the key and endpoint">
    Click Copy next to API Key and note the host in the Endpoint URL, then click Done. Domotz shows the key and endpoint only in this dialog.
  </Step>
</Steps>

See Domotz's [Domotz API](https://help.domotz.com/admin-global-features/domotz-api/) guide.

## Connect it in Triggr

<Steps>
  <Step title="Open the integration">
    Go to **Integrations > Domotz** 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 host and key">
    Enter the API Endpoint Host and API Key, then click **Save Configuration**. For the endpoint `https://api-eu-west-1-cell-1.domotz.com/public-api/v1/`, the host is `api-eu-west-1-cell-1.domotz.com`.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/domotz/configure.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=f45f71f0cdc5f11b63a637866e6c8297" alt="The Domotz configuration window with API Endpoint Host and API Key fields, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="1222" data-path="images/domotz/configure.png" />
    </Frame>
  </Step>
</Steps>

In workflows, run List collectors to find collector IDs (`agentId`) and Collector devices list to find device IDs (`deviceId`). Time ranges use UTC in the format `yyyy-mm-ddThh:mm:ss`.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Requests fail before reaching Domotz">
    API Endpoint Host takes the host name only, with no `https://`, path or spaces.
  </Accordion>

  <Accordion title="Every action fails with an authentication error">
    Check the key is a Full Access key, pasted in full, still listed on API Keys, and that the host matches its Endpoint. If you've lost either value, create a new key and click Edit on the Base Configuration card.
  </Accordion>

  <Accordion title="Collectors are missing">
    The key sees only the collectors its creator can access. Create it as the account owner or an Administrator.
  </Accordion>

  <Accordion title="Calls fail during large workflows">
    Your account has hit a Domotz API limit. Run API usage and limits to check, and spread large workflows out.
  </Accordion>
</AccordionGroup>


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