​

Overview

The Notion integration allows you to query and index Notion pages and databases. It supports both and .

​

Authentication

The Notion integration can be set up as a personal connection or as a shared connection.

​

Personal connection (OAuth)

Each user connects their own Notion account through an OAuth flow, available in Hyperspell as a personal connection without any additional setup. During the OAuth flow, users select which pages in their Notion workspace they want to give access to.

​

Shared connection

An app admin can instead register a single shared connection using a Notion Access Token. Its data is synced once and made available to everyone in your app — no per-user OAuth required. To create the Access Token:

1. Go to https://app.notion.com/developers/connections.
2. Click New connection, enter a name, select Access token as the authentication method, then click Create connection:

3. Open the Content access tab and click Add pages & databases to select which pages the connection can access. We recommend selecting your team workspace — all subpages are added automatically:

4. Back in the Configuration tab, copy the Access Token.

Then register the shared connection with the following field:

​

Search Options

The Notion integration does not support any custom search options.

​

Resources

The Notion integration returns Document resources:

Show Document Schema

​

resource_id

string

required

The unique identifier of the page or database

​

source

string

required

The provider that fetched the document, which is notion if this integration is used to query or index it.

​

title

string

The title of the page

​

summary

text

A summary of the document that can be fed directly into LLMs. When retrieved from the /query endpoint, this may summarize only the sections of the document returned as highlights (ie. parts relevant to your query). Otherwise, it will summarize the entire document.

​

data

elements[]

A structured representation of the page’s content. This field is only returned if the resource is returned from the /documents/get endpoint. If the website is returned from the /query endpoint, this field will be empty and the highlights field will contain the relevant sections of the website.

​

highlights

highlight[]

A list of highlights from the page relevant to the query. This field is only returned if the resource is returned from the /query endpoint.