BusinessHRM Help Center

Guides for every module API & Developers →

Connected apps (Integrations hub)

Connected apps is the one place where every integration is set up. Each app has its own page that explains what it does, what data moves and in which direction, when it runs, and what access it needs — plus its status, last sync, an activity log and alerts.

Where to find itSettings sidebar›Connected apps

The hub

  • Recommended for your country — apps tagged for your company's country (from Country & compliance, or your main address) are shown first.
  • Categories — Messages & alerts, Calendar & meetings, Payments & accounting, Hiring, Government & payroll filing, CRM, Automation, AI & developers, HR devices.
  • Status — Connected (green), Using BusinessHRM (the default service), Needs keys, Needs attention, Failing (red: the last sync or test failed), Not connected, and for government services: File export, Manual record or Via a partner.

An app's page

Part What it shows
Connection Connected / not connected, and the account or organisation it is connected to
Last sync Date, time and result of the last run
When it runs Its schedule or trigger
Buttons Test connection (a real call with the saved settings and a precise error if it fails), Sync now (pick what to sync), Disconnect
What syncs A table: what, direction (BusinessHRM → app, app → BusinessHRM, both ways), when
What it needs access to The permissions or scopes the app asks for
Activity The last 20 runs with counts, errors and a Retry button on failed runs

Alerts when something fails

  • Runs that fail for a temporary reason (timeout, rate limit, the service being down) are retried automatically after 1, 5 and 15 minutes.
  • When a run finally fails, the app turns red on the hub, a banner lists failing apps, and every admin gets a bell notification. With Email admins when it fails on (the default), they also get an email — at most once a day per app.
  • The alert clears itself after the next successful run.

Who can use it

Admins and people whose role allows Manage company settings. QuickBooks and Xero can also be managed with Manage finance settings. Apps only appear when your plan includes the related module.

API

GET /api/v1/integrations, GET /integrations/{app}/logs, POST /integrations/{app}/test, POST /integrations/{app}/sync — see the API docs at /developers.