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.
Set 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.
Configure 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.
Troubleshooting Halo PSA integration setup
Customers are Not Showing Up When Refreshing Options
If you are running into an issue where customers are not showing when refreshing options, this is due to an issue with permissions. Make sure to check that both the User and API user have the following permissions, at minimum:
View Customers
View Support Tickets
Add Time Entries
Create Support Tickets
You may need to uninstall and reinstall the halo integration for the new permissions to take place.
Boards and teams are not visible in configure organizational variable form
If you can't see boards or teams in the configure organizational variable form, this is due to incorrect permissions. In order to resolve this issue, you will need to add the API User to the teams that you want to see in the form.
Email, name, department is missing or CAB ID is invalid
If you run into an issue where the Email, Name, Department, or other information is missing or you see that the CAB ID is either invalid or mandatory, this is due to custom fields used in creating tickets. In order to use these custom ticket fields, you have a couple of options:
The Custom Field IDs need to be added as an organization variable
The Custom Field should not be marked as mandatory
Last updated
Was this helpful?