Integrations
HaloPSA
How to connect HaloPSA to Nova Admin via OAuth.
Connect your HaloPSA instance using client-credentials authentication.
How OAuth connection works
HaloPSA uses OAuth 2.0. Nova Admin stores an access/refresh token pair on your behalf — your password is never stored.
Prerequisites
Before clicking Authorize, complete these setup steps:
- Go to your HaloPSA instance → Configuration → Integration → HaloPSA API
- Create a new Application with Client Credentials grant type
- Grant the 'all' scope or the required permissions for tickets, clients, agents, and users
- Copy your Resource URL (e.g. https://your-tenant.halopsa.com), Client ID, and Client Secret
- Enter them in the fields below to connect.
Credential fields
| Field | Required | Notes |
|---|---|---|
| Resource URL | Yes | https://your-tenant.halopsa.com |
| Client ID | Yes | OAuth client ID |
| Client Secret | Yes | Secret — stored encrypted. |
Connect
In Nova Admin, go to /agents/integrations, find HaloPSA, enter the OAuth credentials above, and click Authorize. You will be redirected to HaloPSA to grant access, then back to Nova Admin.
Troubleshooting
- Redirect URI mismatch: ensure the OAuth app's redirect URI exactly matches the callback URL shown in the connect dialog.
- Scopes error: verify your OAuth app has the scopes listed above enabled.
- Need help?: refer to the HaloPSA OAuth docs.