> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> How to set up the Notion connector, plus the actions and events that are available.

![Notion](https://stackone-logos.com/api/notion/filled/svg)

v2.0.0[See changelog](https://docs.stackone.com/connectors/notion/changelog.md)

[35 actions](#actions) · [9 events](#events) · 3 auth methods

Knowledge Management
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Installation Access Token · Connector Profile](https://docs.stackone.com/connectors/notion/guides/connector-profile/installation-access-token.md)
>
> Best for internal tools and single-workspace integrations. You manually share specific pages with the integration.

> [card] [Personal Access Token · Connector Profile](https://docs.stackone.com/connectors/notion/guides/connector-profile/personal-access-token.md)
>
> Best for personal and developer-owned workflows. A Personal Access Token (PAT) acts as you and uses your own workspace m...

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/notion/guides/connector-profile/oauth-2-0.md)
>
> Recommended for public integrations serving multiple users. Users choose which pages to share during authorization.

Optionally, configure receiving Events for Notion into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/notion/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Installation Access Token · Link Account](https://docs.stackone.com/connectors/notion/guides/link-account/installation-access-token.md)

> [card] [Personal Access Token · Link Account](https://docs.stackone.com/connectors/notion/guides/link-account/personal-access-token.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/notion/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Installation Access Token

OAuth 2.0

Personal Access Token

No auth methods found

35 actions

ActionDescription

Append Block Children`notion_append_block_children`

Add content blocks (text, headings, lists, images, etc.) to an existing page or block. Use this after create\_page to add...

Get Block`notion_get_block`

Retrieve a single block's type, content, and metadata by its block\_id (does NOT return children — use get\_block\_children...

Get Block Children`notion_get_block_children`

Retrieve the content blocks inside a page or parent block. This is how you read a page's actual content (text, headings,...

Update Block`notion_update_block`

Modify an existing block's content (text, headings, to-dos, etc.) by block\_id. ALWAYS call this after reading blocks whe...

Delete Block`notion_delete_block`

Archive (soft-delete) a block by its block\_id. The block is moved to trash, not permanently deleted — it can be restored...

Create Comment`notion_create_comment`

Create a comment on a page or block, or reply to an existing discussion thread. Use the page\_id directly from create\_pag...

List Comments`notion_list_comments`

List all unresolved comments on a page or block, with pagination. Resolved comments are excluded from results.

Retrieve Comment`notion_retrieve_comment`

Retrieve a single comment's full details (content, author, timestamps, parent) by its comment\_id.

Create Database`notion_create_database`

Create a new Notion database under a parent page, with an optional initial schema (columns/properties) defined via initi...

Get Database`notion_get_database`

Retrieve a database's metadata and its list of data sources (with IDs) by database\_id. Does NOT return rows — use query\_...

Update Database`notion_update_database`

Update database-level attributes (title, icon, cover, parent, archive status). To update columns/schema, use update\_data...

Create Data Source`notion_create_data_source`

Add a new data source (with its own schema/columns) to an existing database. Use this when a database needs multiple dat...

Retrieve Data Source`notion_retrieve_data_source`

Retrieve a data source's schema (columns/properties) by its data\_source\_id. To get rows, use query\_data\_source instead....

Update Data Source`notion_update_data_source`

Update a data source's schema (add, rename, or remove columns), title, icon, or trash status. To update row values, use...

Query Data Source`notion_query_data_source`

Query a database's data source to retrieve rows (pages) with optional filtering and sorting. This is how you list or sea...

List Data Source Templates`notion_list_data_source_templates`

List all page templates available for a data source, including each template's ID, name, and default status. Useful befo...

Create File Upload`notion_create_file_upload`

Step 1 of file upload — create a file upload session to get an upload URL. Then call send\_file\_upload (step 2), and comp...

Send File Upload`notion_send_file_upload`

Step 2 of file upload — send the actual file data for a file upload session created by create\_file\_upload. For multi\_par...

Complete File Upload`notion_complete_file_upload`

Step 3 of multi\_part file upload only — finalize after all parts are sent via send\_file\_upload. Not needed for single\_pa...

List File Uploads`notion_list_file_uploads`

List all file uploads created by this bot integration, sorted most recent first. Filter by status (pending, uploaded, ex...

Retrieve File Upload`notion_retrieve_file_upload`

Retrieve a single file upload's metadata and status (pending, uploaded, expired, failed) by its file\_upload\_id. Use afte...

Get Unified Credentials`notion_unified_get_me`

Get the current Notion connection's unified credentials and identity.

List Unified Organizations`notion_unified_list_organizations`

List unified organizations in Notion.

Get Unified Organization`notion_unified_get_organization`

Get a unified Notion organization by ID.

List Unified Users`notion_unified_list_users`

List unified users in Notion.

Get Unified User`notion_unified_get_user`

Get a unified Notion user by ID.

Create Page`notion_create_page`

Create a new page in a Notion workspace. After creation, the returned page object contains the new page\_id — use it dire...

Get Page`notion_get_page`

Retrieve a Notion page's properties and metadata by its page\_id (does NOT return page content — use get\_block\_children f...

Update Page`notion_update_page`

Update page properties, icon, cover, or trash status by page ID. IMPORTANT — You must already have the page\_id; if you o...

Get Page Property`notion_get_page_property`

Retrieve a single page property value by page\_id and property\_id, with pagination support for large properties (title, r...

Move Page`notion_move_page`

Move a page to a different parent page or database. THIS IS THE ONLY ACTION that can change a page's parent location — u...

Search`notion_search`

Search for pages and data sources by title text. Use this to find a page\_id when you only have a page name — required be...

List Users`notion_list_users`

List ALL users (people and bots) in the Notion workspace. Returns the complete set of workspace members across all pages...

Get User`notion_get_user`

Retrieve a single Notion user's profile (name, email, avatar, type) by their user\_id. Get user IDs from list\_users resul...

Get Bot User`notion_get_bot_user`

Retrieve the bot user (integration identity) associated with the current API token, including the workspace\_id and the p...

## Events

Tags

Select all
|
Clear

Comments

Databases

Pages

Webhooks

No tags found

9 events

EventDescriptionTags

URL Verification`notion_url_verification`Manual setup

Handles Notion's one-time webhook verification challenge. Notion requires the verification\_token to be pasted back into...

Webhooks

Page Created`notion_webhook_page_created`

Processes Notion page.created events when a new page is created.

PagesWebhooks

Page Property Values Updated`notion_webhook_page_property_values_updated`

Processes Notion page.property\_values.updated events when page properties are changed.

PagesWebhooks

Page Content Updated`notion_webhook_page_content_updated`

Processes Notion page.content\_updated events when page content is changed. These events may be aggregated and delayed.

PagesWebhooks

Database Created`notion_webhook_database_created`

Processes Notion database.created events when a new database is created.

DatabasesWebhooks

Database Schema Updated`notion_webhook_database_schema_updated`

Processes Notion database.schema\_updated events when a database schema is changed.

DatabasesWebhooks

Comment Created`notion_webhook_comment_created`

Processes Notion comment.created events when a new comment is added to a page or discussion.

CommentsWebhooks

Comment Updated`notion_webhook_comment_updated`

Processes Notion comment.updated events when an existing comment is modified.

CommentsWebhooks

Comment Deleted`notion_webhook_comment_deleted`

Processes Notion comment.deleted events when a comment is removed from a page or discussion.

CommentsWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.