Notion - Stackone

Getting Started

Create or Select a Project

Set up a new project or select an existing one. See Organizations & Projects.

Configure the Connector

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.

Installation Access Token · Connector Profile

Best for internal tools and single-workspace integrations. You manually share specific pages with the integration.

Personal Access Token · Connector Profile

Best for personal and developer-owned workflows. A Personal Access Token (PAT) acts as you and uses your own workspace m…

OAuth 2.0 · Connector Profile

Recommended for public integrations serving multiple users. Users choose which pages to share during authorization.

Optionally, configure receiving Events for Notion into StackOne.

Webhooks setup

Link an Account

Link an account from the dashboard (or via StackOne Hub).See the guide for the authentication type chosen in the Connector Profile:

Installation Access Token · Link Account

Personal Access Token · Link Account

OAuth 2.0 · Link Account

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Actions

35 actions

Action

Description

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

Retrieve a single block’s type, content, and metadata by its block_id (does NOT return children — use get_block_children…

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

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

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

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

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

Retrieve Comment

Retrieve a single comment’s full details (content, author, timestamps, parent) by its comment_id.

Create Database

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

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

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

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

Retrieve a data source’s schema (columns/properties) by its data_source_id. To get rows, use query_data_source instead…

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

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

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

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

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

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

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

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

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

List Unified Organizations

List unified organizations in Notion.

Get Unified Organization

Get a unified Notion organization by ID.

List Unified Users

List unified users in Notion.

Get Unified User

Get a unified Notion user by ID.

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

Retrieve a Notion page’s properties and metadata by its page_id (does NOT return page content — use get_block_children f…

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

Retrieve a single page property value by page_id and property_id, with pagination support for large properties (title, r…

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 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

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

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

Retrieve the bot user (integration identity) associated with the current API token, including the workspace_id and the p…

Events

9 events

Event