Integrations (Workspace API keys)
Settings → Workspace settings → Integrations is where admins connect Xero, QuickBooks, Stripe Connect, and workspace API keys for automation. This is separate from personal API keys in Account settings, which identify you as a user.
Connected services
| Integration | Purpose |
|---|---|
| Xero | Sync contacts, issued invoices, approved expenses, and payments |
| QuickBooks | Sync the same operational records into QuickBooks Online where enabled |
| Stripe Connect | Let clients pay invoices by card (see the Integrations screen in the app) |
| Workspace API keys | Server-side scripts and tools acting on behalf of the workspace |
SiteHut is the operational and commercial workspace: project evidence, approvals, invoice drafts, expense capture, supplier/subcontractor context, and audit history live here. Your accounting system remains the ledger for statutory accounts, supplier payment, CIS filing, VAT/tax review, and reconciliation.
For launch, accounting handoff has three supported paths:
- Live Xero sync for connected UK workspaces.
- Live QuickBooks sync for connected UK or US workspaces.
- The accountant handoff pack, a period-end ZIP fallback containing curated finance CSVs, PDFs, supporting evidence, and a manifest for accountant review.
Permissions
Only members whose role allows integrations (or full workspace management) can view or create keys. If Integrations is missing, ask a workspace admin.
Create an API key
Open Integrations
Go to Settings → Workspace settings → Integrations.
Create a key
Choose Create, name the key (e.g. Production exporter), and select scopes—read vs write, per area. Use least privilege only.
Set expiry and copy secret
Set an expiry if offered. Copy the secret once when shown—it cannot be retrieved again.
Rotating and revoking
- Regenerate when a key might be compromised.
- Revoke unused keys so old secrets stop working immediately.
Technical reference
Base URL, authentication headers, and OpenAPI documentation: API overview.