Reference

commentCreated

Fires when a new comment is posted on a page

databaseContentUpdated

Fires when items in a database are added, updated, or removed

databaseCreated

Fires when a new database is created in the workspace

databaseSchemaUpdated

Fires when the structure of a database changes, such as adding or removing fields. Detect schema changes and update systems that depend on the database.

dataSourceContentUpdated

Fires when data in a connected external system changes. Keep your Notion workspace automatically synchronized with live data from outside sources.

fileUploadCompleted

Fires when a file finishes uploading successfully. Process, distribute, or organize the uploaded file automatically.

pageContentUpdated

Fires when a page's content blocks are changed

pageCreated

Fires when a new page is created in the workspace

pagePropertiesUpdated

Fires when a page's properties (status, date, etc.) change

commentDeleted

Fires when a comment is removed from a page. Audit when discussions or feedback are deleted.

commentUpdated

Fires when someone edits an existing comment. Monitor changes to feedback and discussions in real time.

databaseDeleted

Fires when a database is permanently deleted. Clean up related data and remove dependent integrations.

databaseMoved

Fires when a database is moved to a different location in your workspace. Update references or notify teams affected by the move.

databaseUndeleted

Fires when a deleted database is restored. Reactivate associated workflows and automations.

dataSourceCreated

Fires when you connect a new external data source to Notion. Track when new integrations are added to your workspace.

dataSourceDeleted

Fires when a data source connection is permanently removed. Audit when integrations are disconnected from your workspace.

dataSourceMoved

Fires when a data source is moved to a different location in your workspace. Monitor organizational changes to your integrations.

dataSourceSchemaUpdated

Fires when the structure or fields of an external data source change. Detect updates to external system schemas automatically.

dataSourceUndeleted

Fires when a deleted data source connection is restored. Track when integrations are recovered.

fileUploadCreated

Fires when a file upload starts in Notion. Track new file submissions and attachments as they arrive.

fileUploadExpired

Fires when an upload session expires and is no longer available. Notify users when they need to retry their file uploads.

fileUploadUploadFailed

Fires when a file upload fails to complete due to an error. Alert users and trigger recovery actions automatically.

pageDeleted

Fires when a page is deleted from the workspace

pageLocked

Fires when a page is locked to prevent further edits. Enforce version control or content freeze workflows.

pageMoved

Fires when a page is relocated within your workspace. Update navigation links or notify teams about the move.

pageTranscriptionBlockTranscriptDeleted

Fires when a transcript from an audio or video block on a page is deleted. Track when transcripts are removed from your workspace.

pageUndeleted

Fires when a deleted page is restored. Reactivate workflows and notify teams that the page is back.

pageUnlocked

Fires when a page is unlocked and becomes editable again. Signal that a page is ready for team updates and collaboration.

viewCreated

Fires when a new view like a table, calendar, or gallery is created for a database. Monitor when team members create new data views.

viewDeleted

Fires when a view is removed from a database. Audit view changes and adjust dashboards that may have relied on it.

viewUpdated

Fires when a view's settings or configuration changes. Monitor updates to how data is displayed or filtered.

Append block children

Add new content blocks like paragraphs, headings, to-do items, and tables to an existing Notion page or section. This lets you programmatically expand and organize your Notion workspace without manual editing.

Delete a block

Remove content from your Notion pages programmatically by archiving blocks. When you delete a parent block, all child blocks are automatically archived as well.

Retrieve a block

Retrieves the details and content of a specific block from your Notion workspace, allowing you to inspect exactly what's in a paragraph, heading, to-do item, or other block element.

Retrieve block children

Fetches the nested content blocks within a parent block, allowing you to read and navigate the full structure of pages, toggle lists, and multi-column layouts in your Notion workspace.

Update a block

Modify the content or properties of an existing block in your Notion workspace, such as editing text, updating checkboxes, or changing headings. This lets you keep your Notion pages current without manually opening the app.

Create a comment

Add comments or replies to Notion pages to facilitate team discussions and automated notifications. This enables you to post status updates, feedback, or threaded conversations directly within your Notion workspace.

List comments on a page or discussion

Retrieve all comments from a specific Notion page or discussion thread to monitor feedback and collaborate on content in real-time. This helps you track team discussions, gather stakeholder feedback, and keep external systems synchronized with comment activity.

Retrieve a comment

Fetch a specific comment from your Notion workspace to view its full text content, author details, and creation date. Use this when you need to retrieve or verify the details of a single comment without loading an entire page or discussion thread.

Query a data source

Search and retrieve specific pages from your Notion database using filters and sorting to find exactly what you need. Use this to build filtered reports, look up entries by criteria, or work through large datasets in manageable chunks.

Create a data source

Create a new structured database in Notion with custom fields and data types to organize and track information. This lets you build trackers, inventories, and other organized datasets tailored to your specific needs.

List templates in a data source

Retrieve all available template pages for a data source to see pre-configured page structures that can be applied when creating new entries.

Retrieve a data source

Fetch the schema and metadata of a data source to understand its structure, column types, and configuration before working with it. This helps you verify data layout and plan queries or updates accordingly.

Update a data source

Update a data source's title, description, or property schema to rename columns, add new fields, or change how data is structured in your Notion workspace.

Create a database

Set up a new structured database within Notion by defining properties like text fields, numbers, dates, and relationships. This lets you programmatically create organized data collections for your business without manual setup.

Retrieve a database

Fetches the complete structure and metadata of a Notion database, including its title, properties, and configuration details. Use this to understand how a database is organized before querying its contents or automating workflows with it.

Update a database

Modify your Notion database's structure, title, description, and properties to keep your workspace organized and aligned with your evolving business needs. Update property settings and metadata whenever your tracking requirements change.

Complete a multi-part file upload

Finalize a multi-part file upload and signal to Notion that the file is ready to be processed and attached to your content.

Create a file upload

Start a file upload session in Notion to prepare for uploading files like documents, images, or media that you want to attach to pages and databases.

List file uploads

Retrieve all file uploads associated with your integration to monitor their processing status and determine when they're ready to use in your Notion workspace.

Retrieve a file upload

Check the status and details of a file that you've uploaded to Notion, including whether it's still processing, completed successfully, or failed.

Upload a file part

Send file content to Notion in parts for large file uploads after initiating an upload session. This allows you to transmit large files efficiently without timeout issues.

Exchange an authorization code for tokens

Complete the OAuth connection process by exchanging the authorization code from Notion into access tokens that allow your app to interact with a user's Notion workspace.

Introspect a token

Verify that an access token is valid and retrieve its metadata such as the associated bot user, workspace, and permissions. This helps you validate tokens before use and ensure they have the necessary capabilities for your operations.

Revoke a token

Invalidate an access token to prevent it from being used for future API requests, useful for disconnecting integrations or removing access when it's no longer needed.

Create a page

Add a new page to Notion either as a child of an existing page or as a new database entry, with customizable properties and initial content. Use this to expand your Notion workspace with structured information that integrates with your existing pages and databases.

Retrieve a page

Fetch a page's properties and metadata to access its structured data, timestamps, and configuration details without retrieving its full content.

Update a page's content as markdown

Update a page's content by providing markdown text, which Notion automatically converts into its native block format. This is ideal for bulk content updates or working with markdown-formatted content from other sources.

Update a page's properties

Update any property on a Notion page including title, status, tags, and custom fields to keep your database current. This lets you modify page metadata, change document states, or archive pages without recreating them.

Move a page to a new parent

Move a page to a different parent location in your Notion workspace, allowing you to reorganize your page structure and hierarchies. This is useful when you need to reorganize content, move pages between databases, or restructure your workspace without manual dragging.

Retrieve a page as markdown

Export a Notion page's complete content as markdown text, making it easy to use the content in other applications or store it in a portable format.

Retrieve a page property item

Fetch a specific property value from a Notion page, such as a date, relation, or text field, without retrieving the entire page. This is useful when you only need one piece of information and want to reduce data overhead.

Search by title

Find pages and databases in your Notion workspace by searching their titles, with options to filter by type and sort by relevance or recency. This helps you quickly locate content across your workspace without needing to know its exact location.

List all users

Retrieve all users in your Notion workspace to see who's available for task assignments, mentions, and collaboration.

Retrieve a user

Fetch a specific user's profile information including their name, avatar, email, and account type to display user details or verify team member information.

Retrieve the current bot user

Retrieves information about the authenticated bot integration, including its display name and workspace context. Use this to verify which bot account is connected and confirm it has access to your Notion workspace.