Set up Heimdal
1
Create a dedicated account for Triggr
Heimdal only accepts API requests from the key account’s IP List, which also controls where it can sign in from, so give Triggr its own account. In Accounts, click Create New Account, using your own organisation as the customer and a mailbox you can read.
- Roles: Reseller if you’re an MSP (you need a reseller account yourself), otherwise empty.
- IP List: both of Triggr’s IP addresses, plus the public address you’ll sign in from.
2
Generate the API key
Signed in as the Triggr account, go to Guide > Your Heimdal API Key, generate a key and copy the Personal API Key. Note your own customer ID shown there for reseller-wide actions.
Connect it in Triggr
1
Open the integration
Go to Integrations > Heimdal Security and click Configure on the Base Configuration card.

2
Enter the key
Paste the key into apiKey without 
Bearer in front, then click Save Configuration.
customerId. Find it under Admin > Customers, or run Get Customers with your own customer ID. Dates use the form 2026-10-01T00:00.
Troubleshooting
Every action is refused
Every action is refused
Check apiKey has the current key with no
Bearer or spaces, and both Triggr IP addresses are in the account’s IP List.Reseller actions are refused
Reseller actions are refused
Create Customer, Update Customer, Get Customers (for all customers), Get Active Clients Per Module and Get Active Clients Total need the Reseller role.
A customer's data is missing
A customer's data is missing
Check
customerId is that customer’s ID, not your own, and the customer sits under your reseller.Results stop at 1,000 entries
Results stop at 1,000 entries
Several endpoints return at most 1,000 entries (Group Policy change logs, 10,000). Narrow the date range or page through results.

