Setting up the Halo PSA Integration

  • Updated

Before starting to connect an integration, please read:

The Halo PSA integration allows you to sync over:

  • Companies/Clients
  • Sites
  • Contracts
  • Users

Make sure to test the integration for a successful connection before starting to import!


  1. Navigate to Halo -> Configuration -> Integrations -> HaloPSA API
  2. Click on View Applications, and then create a New Application
  3. Give the Application a Namemceclip0.png
  4. Confirm in the last step that the Active Checkbox is clicked.
  5. Choose Client ID and Secret as the Authentication Methodmceclip1.png
  6. Record the Client ID and Client Secret in a secret place. You will need them later. mceclip2.png
  7. Choose the correct Login Type and Agent to login as.  This can be any user, but we usually recommend creating a dedicated user for this.mceclip3.png

  8. Before saving, choose the Permissions tabmceclip4.png
  9. Choose read:customers to give the app that permissionmceclip5.png
  10. Hit Save
  11. Navigate to the Hudu Admin -> Integrations -> HaloPSA -> Settings page, and enter the client secret, client id, tenant, authorization server, and resource server. Most of this information is available in Halo -> Configuration -> Integrations -> HaloPSA API.


Before contacts and sites will be added into Hudu, you must have an Asset Layout for both of them already created. Make sure the Asset Layout is active. Otherwise, the Asset Layout will not be displayed in the companies.

Matching companies

Hudu's import works in two stages. First, Hudu will look for companies to match in to Hudu. We will attempt to match them with companies already in the system. Then, you will need to match companies before attempting to bring in any company information.

Still have questions?

Contact us