Connector Failures

A connector failure prevents files from syncing from Google Drive or OneDrive into your Hubrix document library. Here is how to diagnose and fix the most common connector problems.

Step 1: Read the error message

When a connector fails, it shows a red Error badge. Click the connector in Settings → Data Connectors to open its detail panel. Look for the error message in the Status section — it is usually specific enough to identify the cause.

Step 2: Token expired — reconnect OAuth

Symptom: Error message contains "token expired", "unauthorized", or "401".

Cause: The OAuth access token Hubrix uses to read your Drive/OneDrive has expired or been revoked.

Fix:

1. Click Reconnect on the connector detail panel.
2. Complete the OAuth flow with your Google or Microsoft account.
3. After reconnecting, click Sync now to verify the connection works.

Step 3: Permission removed — re-authorise

Symptom: Error message contains "403", "forbidden", or "insufficient permissions".

Cause: The Google or Microsoft account used for the connector no longer has access to the connected folder, or the Hubrix app permission was revoked from the account's settings.

Fix:

1. Check that the Drive/OneDrive folder still exists and that the connected account has read access.
2. If the Hubrix app was revoked, click Disconnect then Connect to re-authorise.
3. During reconnection, grant all requested scopes.

Step 4: Folder deleted — remove and re-add

Symptom: Error message references a specific folder ID or says "folder not found".

Cause: A folder that Hubrix was configured to sync has been renamed or deleted in Drive/OneDrive.

Fix:

1. Click the connector and go to the folder list.
2. Find the folder showing the error.
3. Click Remove to remove it from the sync configuration.
4. Click Add folder and select the correct (existing) folder as a replacement.

Step 5: Other error codes