Notion
Also an agent toolNotion workspace integration for pages, databases, comments, and automation workflows
29 actions · 7 triggers
The Notion integration lets you connect Notion to your automations with 29 actions and 7 triggers — and every action is also a tool an AI agent can call. Examples: Create Database, Retrieve Database, Update Database, Query Database (Legacy), Create Data Source. No blank-canvas wiring — connect it and use it in your workflows.
Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.
Triggers 7
Events in Notion that can start a workflow.
Page Created
Fires when a new page is created in the Notion workspace
Page Properties Updated
Fires when a page property value changes
Database Created
Fires when a new database is created
Comment Created
Fires when a new comment is added
Notion Page
Query a database for pages (rows) (POST /databases/{database_id}/query). DEPRECATED on 2025-09-03 in favor of Query Data Source.
Notion Page
Query a data source for pages (rows). Preferred primary list/polling surface on 2025-09-03 (POST /data_sources/{data_source_id}/query).
Notion Object
Search pages, databases, and data sources shared with the integration, by title (POST /search).
Actions 29
What Zervanor can do in Notion.
Blocks5
Retrieve Block
Retrieve a single block object; also works with a page_id (GET /blocks/{block_id}).
Update Block
Update a block's text/content payload for its type; set archived true to soft-delete (PATCH /blocks/{block_id}).
Delete Block
Move a block (and its children) to trash; returns the archived block (DELETE /blocks/{block_id}).
Retrieve Block Children
List first-level children of a block or page; paginated (GET /blocks/{block_id}/children). Nested children require recursive calls.
Append Block Children
Append up to 1,000 new child blocks; optional after to position; nesting depth <= 2 per request (PATCH /blocks/{block_id}/children).
File Uploads5
Create File Upload
[DEFERRED notion-06] Create a file-upload object; returns id + upload URL/mode (POST /file_uploads).
Send File Upload
[DEFERRED notion-06] Upload file content as multipart (POST /file_uploads/{file_upload_id}/send).
Complete File Upload
[DEFERRED notion-06] Finalize a multi-part upload (POST /file_uploads/{file_upload_id}/complete).
Retrieve File Upload
[DEFERRED notion-06] Check the status of an upload (GET /file_uploads/{file_upload_id}).
List File Uploads
[DEFERRED notion-06] List file uploads; paginated (GET /file_uploads).
Data Sources4
Create Data Source
Create a new data source inside an existing database (POST /data_sources).
Retrieve Data Source
Retrieve a data source object including its properties schema (GET /data_sources/{data_source_id}).
Update Data Source
Update a data source title and properties — add/rename/remove columns, change types (PATCH /data_sources/{data_source_id}).
Query Data Source
Query a data source for pages (rows). Preferred primary list/polling surface on 2025-09-03 (POST /data_sources/{data_source_id}/query).
Databases4
Create Database
Create a database (container) as a child of a page (POST /databases). On 2025-09-03 the schema lives on an initial data source.
Retrieve Database
Retrieve a database object including its data_sources[] array (GET /databases/{database_id}).
Update Database
Update database-level attributes such as title, description, is_inline, parent move, and archive/trash (PATCH /databases/{database_id}).
Query Database (Legacy)
Query a database for pages (rows) (POST /databases/{database_id}/query). DEPRECATED on 2025-09-03 in favor of Query Data Source.
Pages4
Create Page
Create a page as a row in a data source or as a child page (POST /pages). Accepts properties, children, icon, cover.
Retrieve Page
Retrieve page metadata and property values by page ID (GET /pages/{page_id}). For body content use Retrieve Block Children.
Update Page Properties
Update a page's properties, icon, cover, and archive/trash state (PATCH /pages/{page_id}). Cannot edit block content here.
Retrieve Page Property Item
Retrieve a single property's value(s); paginated for multi-item properties such as relation, people, rollup, rich_text, title (GET /pages/{page_id}/properties/{property_id}).
Users3
List Users
List all users in the workspace; paginated, bots excluded (GET /users). Requires a user information capability.
Retrieve User
Retrieve a single user object (GET /users/{user_id}). Email presence depends on the granted user-info capability.
Retrieve Bot User (me)
Retrieve the bot user for the current token, including owner and workspace_name (GET /users/me). Useful as a credential health check.
Comments2
Create Comment
Add a comment to a page (parent.page_id) or reply on an existing discussion (discussion_id) (POST /comments). Requires insert comments capability.
List Comments
List unresolved comments for a block (GET /comments). Paginated. Requires read comments capability.
Oauth1
Exchange OAuth Token
Exchange an authorization code (or refresh token) for an access_token (POST /oauth/token). Uses HTTP Basic auth with client_id:client_secret.
Search1
Search
Search pages, databases, and data sources shared with the integration, by title (POST /search).
Nothing matches your search.
Automations using Notion
Build your own automation with Notion in the visual builder.
Automations with Notion
Frequently asked questions
What can I automate with Notion?
29 actions are available — for example: Create Database, Retrieve Database, Update Database, Query Database (Legacy), Create Data Source, and more.
Which Notion events can start a workflow?
7 triggers — for example: Page Created, Page Properties Updated, Database Created, Comment Created.
Can Notion be used as an AI agent tool?
Yes. Every Notion action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.
How is the Notion integration modelled?
Notion is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.