Skip to main content
Notion
Notion
35 actions · 9 events · 3 auth methods
PreviewDocumentsGeneralIAM

Authentication

Installation Access Token

Best for internal tools and single-workspace integrations. You manually share specific pages with the integration.Guides: Connector Profile, Link Account

Personal Access Token

Best for personal and developer-owned workflows. A Personal Access Token (PAT) acts as you and uses your own workspace m…Guides: Connector Profile, Link Account

OAuth 2.0

Recommended for public integrations serving multiple users. Users choose which pages to share during authorization.Guides: Connector Profile, Link Account
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
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
Description
Tags
URL Verification
Manual setup
Handles Notion’s one-time webhook verification challenge. Notion requires the verification_token to be pasted back into…
Verification
Page Created
Processes Notion page.created events when a new page is created.
Page
Page Property Values Updated
Processes Notion page.property_values.updated events when page properties are changed.
Page
Page Content Updated
Processes Notion page.content_updated events when page content is changed. These events may be aggregated and delayed.
Page
Database Created
Processes Notion database.created events when a new database is created.
Database
Database Schema Updated
Processes Notion database.schema_updated events when a database schema is changed.
Database
Comment Created
Processes Notion comment.created events when a new comment is added to a page or discussion.
Comment
Comment Updated
Processes Notion comment.updated events when an existing comment is modified.
Comment
Comment Deleted
Processes Notion comment.deleted events when a comment is removed from a page or discussion.
Comment

Getting Started

1

Create or Select a Project

Set up a new project or select an existing one. See the Projects Guide.
2

Configure the Connector

Enable the connector and set up a connector profile in your project. See Managing Connectors.
https://stackone-logos.com/api/notion/filled/png

Connector Profile

Notion - Installation Access Token
https://stackone-logos.com/api/notion/filled/png

Connector Profile

Notion - Personal Access Token
https://stackone-logos.com/api/notion/filled/png

Connector Profile

Notion - OAuth 2.0
3

Link an Account

Connect an account using StackOne Hub or Auth Link.
https://stackone-logos.com/api/notion/filled/png

Link Account

Notion - Installation Access Token
https://stackone-logos.com/api/notion/filled/png

Link Account

Notion - Personal Access Token
https://stackone-logos.com/api/notion/filled/png

Link Account

Notion - OAuth 2.0
4

Use Actions

Invoke actions using one of the methods below:

Webhook Events

Webhooks setup

Configure receiving Events for Notion into StackOne.