Skip to content

Reconnect a datasource

A datasource needs reauthorization when its Connection Status flips to Reauthorize — typically because a source-platform token expired, the source-side role changed, or an API key was rotated. Reconnecting restores the credentials so sync can continue.

The Connection Status column in Settings → Integrations → Datasources is the signal. Don’t reconnect based on Data Sync Status alone — those two are independent (see Integrations overview for the model).

SymptomAction
Connection Status shows ReauthorizeReconnect
Data Sync Status shows Active but the last-sync timestamp is hours oldFirst check Data freshness — don’t reconnect unless Connection Status actually says Reauthorize
Data Sync Status shows InactiveThe sync was paused (via Stop Data Sync or platform-side). Reconnecting isn’t the fix — re-enable sync from the datasource detail panel.
You rotated an API key on the source platformReconnect with the new key
The source-platform account owner changedThe previous OAuth grant may no longer be valid; reconnect
  1. Go to Settings → Integrations → Datasources and find the affected platform row.
  2. Click the row to open the detail panel.
  3. Click Reauthorize.
  4. Follow the same flow as the original connection — OAuth re-auth in the source platform’s window, or paste the new API key.
  5. Connection Status returns to Connected and Data Sync Status returns to Active.

Stop Data Sync — pausing without disconnecting

Section titled “Stop Data Sync — pausing without disconnecting”

The datasource detail panel has a Stop Data Sync action separate from delete. Use it when you want to keep the credentials in place but temporarily halt sync — for a maintenance window, a billing-driven pause, or while debugging a downstream mismatch. Data Sync Status flips to Inactive until re-enabled; Connection Status stays Connected.

Sync resumes on the platform’s normal schedule. The next scheduled sync pulls any data missed during the disconnection window. Check the DATA panel (top header) for the updated timestamp.

If the integration drops to Reauthorize again shortly after reconnection, the underlying issue is on the source platform side — a permission, role, or token-policy change. See Datasource won’t connect.