Where to find the status
You can see the current status of your data connections under Data Sources in the navigation bar. Each data source shows its status so you can tell at a glance which connections are active and which need your attention.
Status for integrations
Integrations such as Google Analytics or Google Ads connect via OAuth. The status shows whether the authorization is valid and Zweigen can fetch data.
| Status | What it means | What to do |
|---|---|---|
| Connected | Everything is fine — Zweigen can fetch data | Nothing — proceed with resource selection or the dashboard |
| Disconnected | No active connection exists | Reconnect the integration |
| Re-authentication required | The permission has expired or been revoked | Reauthorize the connection; the Google account password may have changed or access was revoked in Google settings |
| Setting up | Authorization succeeded, Zweigen is converging in the background | Wait briefly and refresh the view — this usually takes only seconds |
| Connection selection required | Multiple active connections to the same service exist | Explicitly select the intended connection from the active connections list |
Status for custom data sources and uploads
For file uploads and custom API connections, Zweigen shows the state of the last import:
| Status | What it means |
|---|---|
| Up to date | Last import was successful |
| Import running | Data is being processed — wait a moment |
| Error | Last import failed — check the import log for details |
On import failure, first check the format of the uploaded file or the structure of the API request. The most common causes are changed column names or an expired API key.
How connection status affects dashboard freshness
The freshness status on a dashboard shows how current the displayed data is. A stale indicator often means the underlying data source has not completed a new import yet — or that the connection was interrupted.
Developer: query import status via API
If you send data via the custom API connection, you can query the import status programmatically:
Endpoint: GET /api/integrations/v1/custom-data/imports/status
Parameters: dataSourceId and importRequestId
| Status | Meaning |
|---|---|
PENDING | Request accepted, waiting for processing |
RUNNING | Import is currently being processed |
COMPLETED | Import completed successfully |
FAILED | Import ended with an error |
Recommendation: poll every 2–5 seconds. On FAILED, inspect the error code in the response and fix the issue before retrying.
Related topics
- Integrations – Manage OAuth connections to Google services
- Custom API Connection – Send your own data via API
- Add a Data Source – Set up the right integration or import path
- Dashboards in Zweigen – Understand freshness status on a dashboard
All Data. One system.
Contact
We are happy to help and advise. Send us an email at hi@zweigen.cloud or visit our socials.