---
title: "Authorize Notion integration"
method: GET
path: "/v1/integrations/notion/oauth/authorize"
tags: ["integrations"]
---

# Authorize Notion integration

`GET /v1/integrations/notion/oauth/authorize`

Start Notion OAuth for the current organization.

Only available from the dashboard; requests authenticated with an API key connect with an internal
integration token through `POST /v1/integrations/notion/connect`.

## 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.
- `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 Notion OAuth
- `422` — Validation Error

## Changes

- **2026-09-26** `9c6c72afde2d` — 1 info
  - added the new optional `query` request parameter `new_store`

[Change history](https://skmtc.dev/mixedbread/apis/mxbai-omni/changes/v1/integrations/notion/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)