Halo Integration Setup
This document outlines the requirements and setup for the Halo integration.
This Integration supports multiple instances
Check out the instructions to set up multiple instances here.
Setting up the API account
Before configuring the Rewst integration you must generate an API user. Here is the instruction for the generation of the integration user:
Log in to Halo PSA as an Administrator.
Go to Configuration โ Agents โ New.
Create an Agent for Rewst to use. We suggest naming this user Rewst API or similar.
Grant the user permissions according to what you would like Rewst to do for you.
Navigate to Configuration โ Integrations โ HaloPSA API (Halo Authorization Docs).
Create an Application.
Select View Applications.
Click the New button.
Use the authentication method for Client ID and Secret (Services).
Navigate to the permissions tab.
Select the all option.
Navigate to the following location:
Teams & Agents
>Agents
>"API's Selected Agent"
>Departments & Teams
Click Edit on the top left and within Teams select Add
Select all of the Teams and click Save
Required for Mapping Customers in the Integration
When creating the API Agent, ensure that the Allow use of all Customers
Client Restriction setting is set to Yes
if you want to allow Rewst to interact with your customer records.
Configuring the Integration
Once you have created an API account, you will need to configure the integration within the Rewst platform.
Follow the below steps to configure a new integration:
Log in to the Rewst platform.
Go to the Configuration โ Integrations in the left sidebar.
Click on or search for Halo PSA.
Complete the form with the details you created:
Resource Server Hostname: Halo PSA Resource Server hostname, e.g.
example.halopsa.com
.Client ID: ID for the Application registered in Halo PSA
Tenant ID: When using a cloud-hosted Halo PSA instance this must be specified. This value can be found in the Halo PSA web application under Configuration โ Integrations โ HaloPSA API โ API Details.
Auth Server Hostname: Halo PSA Auth Server hostname, e.g.
example.halopsa.com/auth,
if different from Resource Server HostnameClient Secret: Authentication secret for the Application registered in Halo PSA
Is On-Premise?: Whether or not the Halo PSA instance is hosted on an on-premise server
Save the configuration. Rewst will do a quick validation of your input.
Beneath that integration authentication section you will see the following options:
Suggest Values: This option will attempt to generate mappings between Rewst organizations and child organizations in this integration.
Refresh Options: This will re-read the potential mapping options - both organizations and companies in Halo.
Save Mappings This will apply mapping configuration changes.
Last updated