Docs / Workflows / Integrations / Notion
Notion
Read and write pages, blocks and database entries shared with a Notion connection.
What you can do
Each Notion integration’s page in OAIZ shows these uses, with its events and its read and write actions, under What you can do with Notion.
- Meeting notes
- Create a meeting notes page for each meeting.
- Lead database
- Add each new lead to a Notion database.
- Answers from Notion
- Answer your team’s questions from your Notion pages.
Connection scope
The connection reaches content shared with it in Notion. A page’s properties describe metadata such as title or status. Blocks hold the page body. A database can contain multiple data sources, each with its own property schema.
Connecting
Authorize OAIZ in Notion, choose the workspace and select the pages or databases to share. You need full access to each resource you select. Sharing a parent page also shares its available child pages.
The connection requests Read content, Insert content, Update content and Comment capabilities. Page and database tools can reach content shared with the connection.
Read actions
- Get Page
- Read a page’s metadata and database properties.
- Read Page
- Read a page’s metadata, properties and top-level body blocks as Markdown. Cursor pagination continues beyond 100 blocks.
- Get Block Children
- Read one level of nested blocks as Markdown and raw block data.
- Query Database
- Read entry properties from one data source with filters, sorting and pagination.
- Get Database
- Read database metadata and data source IDs. A selected or sole source also returns its property schema.
- Search
- Find shared pages and databases by title. Results do not include matches from page bodies.
- List Users
- List workspace people and bots with their IDs and profiles.
Write actions
- Create Page
- Create a page with Markdown beneath a page or a database. Database entries use the selected data source’s property schema.
- Update Page
- Change a page’s icon, cover or archive state, or a database entry’s properties.
- Append Block Children
- Add Markdown content beneath a page or block without replacing existing content.
- Create Database
- Create a database as a child of a page.
- Update Database
- Change a database’s title, description or selected data source’s column schema.
Events
Notion publishes supported page, database, data-source and comment changes. These events describe a change and its IDs. They are not a complete copy of a page’s body. Read actions fetch the content used by the next action.