Admin Reference
Integrations Route Reference
Understand the connection-management surface, sync log, and its redirect behavior into Connected Systems.
Before you start
- You need connection state or sync-log detail for an external system.
Expected outcome
You can understand both the standalone route entrypoint and the embedded connection-management surface inside Connected Systems.
What this route is for
Integrations is the legacy standalone entrypoint for connection management, sync history, linked-entity review, and conflict handling.
Visibility and route behavior
| Item | Details |
|---|---|
| Route id | integrations |
| Current behaviour | Redirects into #/connected-systems?section=connections. |
| Visibility | Customer-facing when connected-system capability is enabled. |
| Direct inbound | Dashboard integration summary, shell nav in older links, and global search results. |
Main regions, dialogs, and controls
| Surface | What it does |
|---|---|
| Connections | Active and historical connection state. |
| Connection control | Test, restore, edit, full sync, or remove a connection. |
| Sync log | Sync history and detail review. |
| Linked entities and conflicts | Shows mapping issues and conflict resolution choices. |
| Dialog layer | Create, edit, disconnect, and sync-detail flows. |
Key actions
- Create or edit a connection.
- Test or restore a connection.
- Run a full sync.
- Push or pull supported data types such as sites, inspections, quotes, and work orders.
- Resolve conflicts by keeping Deucalion data or the client-system version.
Filters and URL state
| Param | What it controls |
|---|---|
connectionId | Selected connection |
status | Connection status filter |
entityType | Linked-entity scope |
direction | Sync direction |
create | Opens create mode |
- In customer-facing use, this state is usually preserved through the Connected Systems hub rather than staying on the standalone route.
Outputs and side effects
- Creates, updates, restores, or removes external connections.
- Runs sync activity that changes what CRM, site, system, asset, quote, or work-order data exists elsewhere.
- Writes conflict decisions back into the integration workflow.
Inbound links
- Dashboard integration summary.
- Shell or bookmarked
#/integrationsentrypoints. - Connected Systems
connectionstab.
Outbound links
- Redirect to
#/connected-systems?section=connections
Indirect handoffs
- Integration health here affects data quality across Customers, Sites, Systems, Assets, Quotes, and Work Orders.
- Apparent register problems often trace back to sync state rather than bad manual edits.
Troubleshooting
| Symptom | What to check |
|---|---|
| The standalone route immediately changes URL | That is expected. Connection management now lives under Connected Systems. |
| Sync history looks incomplete | Re-check the selected connection, direction, and entity filters. |
| Imported data keeps reverting | Confirm the upstream source system or sync direction is not overwriting manual changes. |