---
title: "Connect Notion with an internal integration token"
method: POST
path: "/v1/integrations/notion/connect"
tags: ["integrations"]
---

# Connect Notion with an internal integration token

`POST /v1/integrations/notion/connect`

Connect a Notion workspace using a customer-created internal integration token (no OAuth).

## Request body

- NotionManualConnectBody — Request body for connecting Notion with a customer-created internal integration token.
  - `access_token` string, required — Notion internal integration token (ntn_… or secret_…)
  - `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.
  - `store_config` IntegrationStoreConfig — Store and file configuration chosen when connecting a data source. Applied to the ingestion store when the connector creates it and to every imported file. The defaults (contextualization on, high-quality ingestion) give the best retrieval quality and downstream availability. A pre-existing store keeps its own configuration; only the ingestion mode still applies to newly imported files.
    - `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.

## Response `200`

The connected Notion installation

- IntegrationInstallationResponse — Integration installation response.
  - `data` IntegrationInstallation, required — Service-level representation of an installed provider integration.
    - `id` string, required — The integration installation ID
    - `created_at` string, date-time, required — The creation time
    - `updated_at` string, date-time, required — The last update time
    - `organization_id` string, required — The organization ID
    - `provider` string, required — The integration provider identifier
    - `external_account_id` string, required — The provider workspace/account ID
    - `external_account_name` string, nullable, required — The provider workspace/account name
    - `installed_by_user_id` string, nullable, required — The Mixedbread user who installed the provider
    - `status` string, required — The installation status
    - `scopes` string[], nullable, required — Granted provider scopes
    - `metadata` object, required — Provider-specific metadata

## Other responses

- `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 info
  - added the new optional request property `new_store`
- **2026-09-21** `b12f43c90ba3` — 2 warning
  - added the new `bucket_unavailable_error` enum value to the `code/anyOf[subschema #1: ErrorCode]/` response property for the response status `409`
  - added the new `bucket_unavailable_error` enum value to the `code/anyOf[subschema #1: ErrorCode]/` response property for the response status `422`
- **2026-09-15** `957bf8ec8df8` — 2 warning
  - added the new `store_frozen_error` enum value to the `code/anyOf[subschema #1: ErrorCode]/` response property for the response status `409`
  - added the new `store_frozen_error` enum value to the `code/anyOf[subschema #1: ErrorCode]/` response property for the response status `422`
- **2026-09-10** `adde8ecfa74f` — 1 warning, 4 info
  - removed the optional property `detail` from the response with the `422` status
  - added the non-success response with the status `409`
  - added the required property `code` to the response with the `422` status
  - added the required property `message` to the response with the `422` status
  - …1 more

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