Search documentation

Search for a topic, a control, or an event type.

    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.