Set up HaloPSA
1
Create an agent for Triggr
In Configuration > Teams & Agents > Agents, create an agent such as
Triggr API with access to every client and team your workflows use. Triggr can only see and change what this agent can.2
Create an API application
In Configuration > Integrations > Halo API, click View Applications, then New:
- Authentication Method: Client ID and Secret (Services)
- Login Type: Agent, with Agent to log in as set to your Triggr agent
- Permissions tab: tick all
3
Find your Halo address
API Details on the Halo API page shows your Resource Server, such as
https://yourcompany.halopsa.com/api. Your Halo address is that URL without /api.Connect it in Triggr
1
Open the integration
Go to Integrations > HaloPSA and click Configure on the Base Configuration card.

2
Enter your Halo details
Enter your Halo address as BaseURL, plus the ClientID and ClientSecret. Leave TenantID blank, then click Save Configuration.


Map your clients
On the Client Mapping card, click Apply 100% Matches, then choose the Halo client in Mapped to for anyone left. Triggr saves each match as the client’shaloId variable.

The Client Mapping card, shown here for ConnectWise Manage.
Troubleshooting
Authentication fails, or Halo rejected the configured credentials
Authentication fails, or Halo rejected the configured credentials
BaseURL must start with
https:// and not end in /api or /. In Halo, check the application is enabled, uses Client ID and Secret (Services) and has the all permission, then re-copy the Client ID and Client Secret.client ID is required (provide halo_client_id or ensure the current client is mapped in the HaloPSA integration)
client ID is required (provide halo_client_id or ensure the current client is mapped in the HaloPSA integration)
A Create Ticket step ran for a client with no
haloId. Map the client on the Client Mapping card, or set the step’s Client ID to the client’s haloId variable.Clients are missing from Client Mapping
Clients are missing from Client Mapping
The Triggr agent can’t see them. Give it access in Halo, then click Refresh on Client Mapping.
An action is refused
An action is refused
Give the Triggr agent the permission or team access the action needs.
Could not reach Halo, or Halo is hosted on-premises
Could not reach Halo, or Halo is hosted on-premises
Triggr needs a public address with a certificate from a trusted authority. Publish Halo there and allow Triggr’s IP addresses through your firewall.

