Connections, syncs and the review queue
Connect HubSpot and QuickBooks Online, set up each connection's sync, review what it brings in, and fix failing syncs.
Partly in the app today. Items marked Planned are not built yet.
On this page
Company admins open Connections (app.os.construction/companies/<your company>/connectors) from the Admin section of the navigation. The page lists your syncs, the connector catalog, the ways to bring outside data in that work today, and the connect buttons for each provider.
Connector catalog
Each connector shows a status:
- Available: you can connect it now.
- Preview: built and tested against the provider’s documented API, but not yet verified with a customer account. You can use it; check the first results carefully.
- Not configured on this server: the connector works but this deployment has not registered its provider app yet.
- Planned: not built yet.
The integration directory lists every provider and its status.
Connect an account
- On Connections, select Connect HubSpot. Only company admins see the button. QuickBooks Online is authorized from Accounting > Imports > ERP connections; see Connect QuickBooks Online.
- Sign in at the provider and approve access for os.construction.
- If your sign-in reaches several accounts, Connections asks which one to connect. Pick one; connect again later to switch.
- You return to Connections, which shows the connected account.
Each company connects its own accounts. Sign-in uses OAuth with PKCE; os.construction never sees your password. Tokens are stored encrypted for your company only, refreshed automatically, and never shown in the app or returned by the API. Disconnect removes the connection and its stored credentials here; remove the app’s access in the provider’s settings to revoke it there too.
Set up a sync
Every connected account appears under Syncs. Select Set up sync, then open it.
- Resources: what to read (and, for QuickBooks Online, what to push). Each resource says what a run does with it.
- Direction: read only, push only, or both, where the provider supports pushes.
- Schedule: every hour, every 6 hours, daily, or manual only. Pause stops scheduled runs; Run now always works.
- Mappings: link your projects, vendors, GL accounts and cost codes to the provider’s records. Matches found automatically (an imported record, an equal number) are shown as Matched.
- History: every run with its counts and errors. Failed records lists records that could not be read or pushed; Retry runs just those again.
The review queue
Nothing from a provider is written into os.construction, and nothing is sent to a provider, until someone decides. Each sync has a review queue:
| Item | Your choices |
|---|---|
| New record (for example a HubSpot contact) | Create new, Link to one of the listed possible duplicates (same email, same name, same website), or Ignore |
| Changed record that is already linked | Apply change (shows before and after), or Ignore |
| Accounting record changed or deleted in QuickBooks | Dismiss (keep ours). Accounting records are never changed from QuickBooks; update them here yourself if needed. |
| Push to QuickBooks | Approve push or Do not push. Blocked items say what to map first. |
Accounting items also need the accounting manage integrations permission.
What each provider syncs
| Provider | Status | What syncs |
|---|---|---|
| QuickBooks Online | Preview (sync and push); Available (on-demand pull) | Vendors, customers, accounts, products and services into reviewed imports; reviewed push of posted AP bills and bill payments. See Connect QuickBooks Online. |
| HubSpot | Preview | Contacts and companies, read only, into CRM contacts and organizations after review. Deals are planned. Nothing is written to HubSpot, and records deleted in HubSpot are not detected. |
| Procore | Planned (ongoing sync) | Project imports run from the Migration tool today. |
| Microsoft 365, Google Workspace | Planned | Filing mail and calendar items as project correspondence is planned. |
When a sync fails
The sync’s health shows Healthy, Needs attention (a recent failure or failed records), Failing (three or more failed runs in a row), Paused or Never synced. After three failed runs in a row, company admins get an email, at most once a day while it keeps failing. Common causes:
- Authorization revoked or expired: reconnect the account (or reauthorize QuickBooks), then select Run now.
- Provider rate limit or outage: the next scheduled run continues where the last one stopped.
- No permission in the provider: the connected user cannot see that tool or project there.
Each run also emits a connector.sync_completed or connector.sync_failed event, so webhooks and automations can react to it.
Saved provider connections
The table at the bottom lists every saved connection with its recorded credential state. A recorded credential does not prove the provider still accepts it; the sync’s health and history do.
Keep exploring
Related across os.construction
- GlossaryERP (Enterprise Resource Planning)Software that runs a company's core business processes, like accounting, payroll, purchasing and job cost, on one database.
- DocsAccounting imports and integrationsImport opening balances, open AP/AR, journals, master data and payroll YTD, and connect QuickBooks Online, through one reviewed company accounting workflow.
- DocsConnect QuickBooks OnlineAuthorize a QuickBooks Online connection, schedule an incremental sync into reviewed imports, push approved AP bills and payments, and fix common connection problems.
- BlogWhy construction needs an operating system, not another appMost contractors don't have a software problem. They have a seams problem: the same number lives in five systems and none of them agree. The fix is a shared record, not another tool.
- GlossarySingle Source of Truth (Data Core)One authoritative record for each piece of data, so every team and report reads the same number instead of copies.
- BlogProject Financials and company Accounting: where the records meetUnderstand the difference between a project budget or commitment and the company books, and the handoffs that still need review.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →