Connect HaloPSA and choose what syncs
How to connect HaloPSA to Current as your PSA: authorise an API application in Halo, the client-credentials keys, hosted vs on-prem URLs, the one-PSA rule, project resync and time backfill, and what the first sync pulls.
On this page · 7 sections
Connect HaloPSA and Current works from the clients, tickets, projects, contracts and time your team already keeps in Halo. Every company page shows its service load and recurring revenue, a won Halo quote becomes a project in a few guided steps, and business reviews fill their delivery chapters from the tickets you really closed.
What it does for you
| Where in Current | What you get |
|---|---|
| Service desk tickets | HaloPSA tickets appear in service desk ticket search beside your desk tickets, open and closed, so an engineer finds what was done for a customer last time without opening Halo. Once ticket and time sync is on, desk tickets, their notes and the time logged on them go to HaloPSA too: each time entry lands on the linked HaloPSA ticket as an action, and HaloPSA never emails the customer about it. To change a time entry that is already in HaloPSA, change it in HaloPSA; the hours come back to Current on their own. |
| Company page | Each client's HaloPSA tickets, its contracts with their monthly recurring revenue, its opportunities and, with Halo's own surveys, its satisfaction scores, so an account manager walks into a call knowing how the account is being served. |
| Alerts | An urgent ticket, a security incident or an unhappy customer on a client alerts its account owner by bell and email, a bad Halo survey score raises a follow-up for the account manager when that alert is on, and a stalled or failing sync rings a tenant admin's bell with a link to Sync health. |
| My Day | The HaloPSA project tasks assigned to you sit in today's work (with the service desk on, your HaloPSA tickets too), won Halo quotes wait in Won quotes to convert, and the time you log goes to Halo with the charge rate and contract you picked. |
| Reports and dashboards | Tickets opened, closed and still open, with close times, on dashboards and in the Service report, read from the same HaloPSA tickets your team works. |
| Business reviews | Tickets, projects and contracts fill the service delivery part of each review, and Halo survey scores fill its satisfaction page when surveys are on, so the review is drafted from what you delivered. |
| Sales | HaloPSA opportunities sit in your pipeline and stage moves go both ways, contracts feed the whitespace grid so an unsold service stands out, and urgent or unhappy tickets on your accounts show in Hot tickets on Sales home. |
| Ask Current | Ask about a client and Ask Current answers from its HaloPSA tickets and contracts, with a link to each ticket it used. Contract values show only to people allowed to see money. |
Halo stays the source of truth for time, billing and financials, while Current owns scheduling and the views your team works in. Clients, contacts, opportunities, projects, tickets, contracts and time all flow in, and the writes you allow flow back.
Before you start
- A HaloPSA administrator login, so you can create an API application in Halo's configuration.
- Your Halo instance URL, the address you sign in at. Hosted tenants look like https://yourcompany.halopsa.com; on-premises instances use your own host, like https://support.yourcompany.com.
- Tenant Admin role in Current. Integrations are an admin-only action.
If you want to get Halo itself ready first (the won/lost statuses, project ticket types, charge rates, and agent emails) work through "Prepare your HaloPSA before onboarding: the setup checklist" before you paste a single credential.
Create the API application in Halo
- 1Open Configuration → Integrations → Halo APISign in to Halo as an administrator and go to Configuration → Integrations → Halo API. This page lists every application allowed to reach Halo's API.
- 2Authorise a new applicationClick "Authorise a new application". For the Authentication Method, choose "Client ID and Secret (Services)", the client-credentials flow meant for a background integration like Current, with no person signing in.
- 3Note the Client ID and Client SecretHalo shows a Client ID and generates a Client Secret for the application. Copy both into a password manager. The secret is your credential, so treat it like a password and never publish it.
- 4Grant the permissions (scope)On the application's Permissions tab, grant the areas the sync needs. If you're unsure, Halo's own guidance is to set the scope to "all", which grants every area. Only permissions enabled here can be used, so an under-scoped application quietly returns empty data rather than an error.
- 5Read your API DetailsThe API Details section on the same page shows your Authorisation Server URL and Resource Server URL, plus your Tenant name for hosted instances. Current derives these from your instance URL automatically, but note them. Some hosted tenants use a separate auth subdomain, and the Tenant value is required on hosted Halo.
Connect in Current
- 1Open Settings › Integrations and press the HaloPSA rowThe drawer opens with its card. Only Tenant Admins can connect it or change its keys; anyone else who opens it sees a short summary.
- 2Enter your instance URL, Client ID, and Client SecretPaste your Halo instance URL and the Client ID and Client Secret from the application you just authorised. Current works out the Authorisation Server and Resource Server addresses from your instance URL; if your hosted tenant uses a separate auth host or needs a Tenant value, those fields are there to set. The instance URL isn't a secret; the Client Secret is, and it's kept server-side only once stored.
- 3Run the test connectionCurrent fetches an access token from your Halo auth server and makes one cheap authenticated read to prove the credentials are real before anything is stored. Secrets are encrypted at rest and never sent to the browser again.
- 4Nothing has synced yet. That's deliberateConnecting stores credentials and connection details only. No data is pulled until the first sync runs, so you can connect, review the sync-behaviour switches, and pull on your schedule.
- 5Start the initial pullClients, sites, contacts, agents, opportunities, projects, tickets, contracts, and time entries come across. Large instances take a while; the sync paces itself under Halo's rate limit and resumes automatically if interrupted.
The delta poll
After the first pull, Current polls Halo for changes on a schedule. Pushes (the writes you allow) go out immediately, not on the poll. Halo doesn't offer a single "changed since" filter across every record the way Autotask and ConnectWise do, so for some records Current compares what it last saw rather than asking Halo for a delta, which is why Halo syncs are paced carefully against Halo's rate limit (700 requests every 5 minutes). It's slower to notice a change than a timestamp-driven PSA, but it never misses one.
Who owns which field
The field-ownership map prevents the two systems from fighting. Current never overwrites a Halo-owned field on push, and Halo pulls never clobber a Current-owned field.
| HaloPSA owns | Current owns |
|---|---|
| Project, ticket, and task names and status | Task start and end dates |
| Hours worked, charge rates, contracts, invoicing | Critical-path and milestone flags |
| Time-entry billing and invoice status | Project health (Current Score) |
For the field-by-field detail, see "HaloPSA sync: the complete field-mapping reference".
Disconnecting, and switching PSAs
- Disconnect lives in the Manage drawer's danger zone and requires typing DISCONNECT. It stops all syncing but deletes nothing already pulled.
- Projects that were syncing to HaloPSA freeze rather than break: they keep their data, show a clear synced-to-a-disconnected-PSA state, and make no Halo calls until you reconnect.
- Switching to another PSA is disconnect-then-connect: disconnect Halo here, then connect the other PSA from its own card.
- Switching is free on a fresh workspace, but once you've synced a real book from Halo, connecting a different PSA is blocked at connect time so the two providers' records can't collide on their ids, email support@current.day and we'll run a guided migration first.
