---
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 for the current organization.

## Query parameters

- `store_name` string, nullable — Optional ingestion store name
- `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
- `422` — Validation Error

## Changes

- **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/427a5c58f68a?raw)