Google Drive Connector

Connecting Google Drive lets Hubrix automatically sync files from your Drive into your document library on a schedule you control.

The Google Drive connector setup screen showing the OAuth button and folder picker
The Google Drive connector setup screen showing the OAuth button and folder picker

How to connect

  1. Go to Settings → Data Connectors (or Settings → Integrations).
  2. Click Add connector and select Google Drive.
  3. Click Connect Google Drive.
  4. You are redirected to Google's OAuth consent screen. Select the Google account you want to connect.
  5. Review the permissions Hubrix is requesting (see below) and click Allow.
  6. You are redirected back to Hubrix with the connector active.

After connecting, the Folder Picker opens automatically so you can select which folders to sync.

Permissions requested

Hubrix requests the following Google Drive scope:

ScopeWhy it is needed
drive.readonlyRead files and folder listings from your Drive

Hubrix does not request write access to your Drive. It cannot create, modify, or delete any files in your Google account.

Hubrix only reads files in the folders you explicitly select. It does not scan your entire Drive or access files in folders you haven't chosen.

What gets synced

On each sync run, Hubrix:

  1. Lists files in your selected folders.
  2. Checks which files are new or modified since the last sync (using Google Drive's change tokens).
  3. Downloads only the new or changed files.
  4. Adds them to your Documents library and re-indexes them.

Google Workspace formats are converted automatically: Google Docs become DOCX, Sheets become XLSX, Slides become PPTX.

Reconnecting after a token expires

Google OAuth tokens can expire, especially if your Google account security settings changed or you revoked the Hubrix app permission. When this happens:

  1. The connector shows a red Error badge with a message about the expired token.
  2. Go to Settings → Data Connectors, click the connector, and click Reconnect.
  3. Complete the Google OAuth flow again.

If you remove Hubrix's access from your Google account's app permissions page (myaccount.google.com/permissions), the connector will stop working. You will need to reconnect from Hubrix to restore sync.

Disconnecting

To disconnect the Google Drive connector:

  1. Go to Settings → Data Connectors.
  2. Click the connector and then Disconnect.
  3. Choose whether to keep or delete the synced documents from your Hubrix library.

Disconnecting revokes Hubrix's access token. Your Google Drive files are not affected in any way.

Was this helpful?