Notion
Create and read Notion pages, read databases, and search your workspace from inside an agent workflow.
Notion actions let an agent work with your workspace directly in a flow. An agent can create and read pages, read databases, and search the workspace, then pass the results to later steps.
Supported actions
| Group | Actions |
|---|---|
| Page | Create, Get |
| Database | Get |
| Search | Search |
Prerequisites
How to use these actions
- Map text inputs from earlier steps. Inputs such as Query and the JSON fields accept a value mapped from a previous step.
- Page Size takes a fixed value. Enter Page Size as a fixed value.
- Create a page under a database or another page. Supply either a Parent Database ID to create the page inside a database, or a Parent Page ID to create it under another page.
- Properties and children are JSON. Page properties and block children are provided as JSON.
- List and search results page with a cursor. Pass the Start Cursor to page through more results.
Actions
Page
Notion Page Create
Creates a new page.
| Input | Required | Description |
|---|---|---|
| Parent Database ID | Conditional | The database to create the page inside. Provide this or Parent Page ID. |
| Parent Page ID | Conditional | The page to create the new page under. Provide this or Parent Database ID. |
| Properties JSON | Yes | The page properties as JSON. |
| Children JSON | No | The block children as JSON. |
| Icon | No | An emoji or an external URL. |
| Cover URL | No | A cover image URL. |
Notion Page Get
Retrieves a page by ID.
| Input | Required | Description |
|---|---|---|
| Page ID | Yes | The unique identifier of the page to retrieve. |
Database
Notion Database Get
Retrieves a database by ID.
| Input | Required | Description |
|---|---|---|
| Database ID | Yes | The unique identifier of the database to retrieve. |
Search
Notion Search
Searches your workspace for pages and databases.
| Input | Required | Description |
|---|---|---|
| Query | No | The search text to match. |
| Filter Object Type | No | Limit results to one type, either page or database. |
| Sort Direction | No | The sort direction, either ascending or descending. |
| Sort Timestamp | No | The timestamp to sort by, last_edited_time. |
| Page Size | No | Maximum number of results to return, from 1 to 100. |
| Start Cursor | No | Pagination cursor. The cursor to start from. |
Example
An agent that logs a meeting summary to a Notion database:
A Notion Search action with Filter Object Type set to database lets a model step confirm the target database ID.
A Notion Page Create action sets Parent Database ID to that database and maps Properties JSON to the meeting title, date, and owner, with the summary supplied through Children JSON.
A model step summarizes the created page, including its returned identifier, for the activity log.
Troubleshooting
For issues common to every vendor, see the Actions overview.