---
title: "Authorize Google Drive integration"
method: GET
path: "/v1/integrations/google_drive/oauth/authorize"
tags: ["integrations"]
---

# Authorize Google Drive integration

`GET /v1/integrations/google_drive/oauth/authorize`

Start Google Drive OAuth that connects a Google account as a new installation.

Every call creates an installation, also for an account the organization already connected, e.g. the same
mailbox feeding a second store; the same account in another organization is that organization's own. To
refresh an existing installation's credentials, reconnect it through
`GET /v1/integrations/google_drive/installations/{installation_id}/oauth/authorize` instead.

After consent the browser returns to the organization's return URL with `status`, `installation_id` or
`error`, and `reference`. `error` is `store_in_use` when another installation of the account already feeds
the store, `store_exists` when `new_store` names a store that exists by then, `store_change_on_refresh` or
`reconnect_account_mismatch` for the deprecated `installation_id`, and otherwise the provider's error (such
as `access_denied`), `invalid_state`, `token_exchange_failed` or `callback_failed`.

## Query parameters

- `store_name` string, nullable — Ingestion store name. A store that already exists is shared: every data source connected to it ingests into it, except another installation of the same account, which would ingest every item again. Without it, the account's default store, numbered past a store another installation of the account feeds. Rejected with 422 when the connect refreshes an existing installation and names a store other than its own.
- `new_store` boolean — Ingest into a store created for this connection: the connect fails with 409 when `store_name` names a store that already exists, and without `store_name` the default name is numbered past existing stores. Rejected with 422 when the connect refreshes an existing installation, which keeps its store.
- `installation_id` string, uuid, nullable — Google Drive installation ID when reconnecting an existing installation. Deprecated: use GET /v1/integrations/google_drive/installations/{installation_id}/oauth/authorize.
- `reference` string, nullable — Opaque value echoed back as `reference` on the return URL, so your app can match the outcome to the user who started the flow
- `metadata_contextualization` boolean — Contextualize chunks with the connector's curated metadata fields
- `file_contextualization` boolean — Generate an LLM context for each chunk situating it within the full document
- `ingestion_mode` 'fast' | 'high_quality' — Strategy for adding a file to a store.

## Other responses

- `307` — Redirect to Google OAuth
- `409` — The store already receives data from another installation of the same account, `new_store` names a store that already exists, a Slack workspace bot is already installed by a different Mixedbread organization, or a Notion internal integration that is already connected is asked for a new or different store
- `422` — The request failed validation, the credentials it carries were rejected, or `new_store` is set on a connect that refreshes an existing installation

## Changes

- **2026-09-26** `9c6c72afde2d` — 1 warning, 6 info
  - removed the optional property `detail` from the response with the `422` status
  - added the new optional `query` request parameter `installation_id`
  - added the new optional `query` request parameter `new_store`
  - added the non-success response with the status `409`
  - …3 more
- **2026-09-08** `ce403656bc18` — 1 info
  - added the new optional `query` request parameter `reference`
- **2026-09-07** `1a6549d3e64d` — 2 breaking
  - for the `query` request parameter `file_contextualization`, default value was changed from `false` to `true`
  - for the `query` request parameter `ingestion_mode`, default value was changed from `fast` to `high_quality`

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/google_drive/oauth/authorize/get.md)

---

[API](https://skmtc.dev/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.dev/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc.dev/mixedbread/apis/mxbai-omni/revisions/9c6c72afde2d?raw)