> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> 35 actions available for Notion through StackOne. Use via Actions RPC, Toolset SDK, MCP, or A2A.

<div className="not-prose" style={{ display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '24px' }}>
  <img src="https://stackone-logos.com/api/notion/filled/png" alt="Notion" className="connector-page-icon" style={{ width: '48px', height: '48px', borderRadius: '10px', padding: '2px' }} />

  <div>
    <div style={{ fontSize: '24px', fontWeight: '600' }}>Notion</div>
    <div className="connector-page-subtitle" style={{ fontSize: '14px' }}>35 actions · 9 events · 3 auth methods</div>

    <div style={{ display: 'flex', flexWrap: 'wrap', gap: '6px', marginTop: '8px' }}>
      <span className="connector-page-tag-preview" style={{ display: 'inline-block', padding: '2px 8px', borderRadius: '4px', fontSize: '11px', fontWeight: '500' }}>Preview</span>
      <span className="connector-page-category-tag" style={{ display: 'inline-block', padding: '2px 8px', borderRadius: '4px', fontSize: '11px', fontWeight: '500' }}>Documents</span>
      <span className="connector-page-category-tag" style={{ display: 'inline-block', padding: '2px 8px', borderRadius: '4px', fontSize: '11px', fontWeight: '500' }}>General</span>
      <span className="connector-page-category-tag" style={{ display: 'inline-block', padding: '2px 8px', borderRadius: '4px', fontSize: '11px', fontWeight: '500' }}>IAM</span>
    </div>
  </div>
</div>

## Authentication

<Columns cols={2}>
  <Card title="Installation Access Token">
    Best for internal tools and single-workspace integrations. You manually share specific pages with the integration.

    Guides: [Connector Profile](/connectors/notion/guides/connector-profile/installation-access-token), [Link Account](/connectors/notion/guides/link-account/installation-access-token)
  </Card>

  <Card title="Personal Access Token">
    Best for personal and developer-owned workflows. A Personal Access Token (PAT) acts as you and uses your own workspace m...

    Guides: [Connector Profile](/connectors/notion/guides/connector-profile/personal-access-token), [Link Account](/connectors/notion/guides/link-account/personal-access-token)
  </Card>

  <Card title="OAuth 2.0">
    Recommended for public integrations serving multiple users. Users choose which pages to share during authorization.

    Guides: [Connector Profile](/connectors/notion/guides/connector-profile/oauth-2-0), [Link Account](/connectors/notion/guides/link-account/oauth-2-0)
  </Card>
</Columns>

<div className="connector-meta-library-section">
  <div className="connector-meta-library-title">Actions</div>

  <div className="connector-actions-controls not-prose" data-connector-actions-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-actions-search placeholder="Search actions" aria-label="Search actions" />
    </div>
  </div>

  <div className="meta-library-count" data-connector-actions-count>35 actions</div>

  <div className="not-prose meta-library-table-container" data-connector-actions-table>
    <div className="connector-meta-library-grid" style={{ gridTemplateColumns: '200px 1fr' }}>
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Action</div>
        <div className="meta-library-grid-header-cell">Description</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_append_block_children" data-action-label="Append Block Children" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Append Block Children</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_append_block_children" aria-label="Copy notion_append_block_children"><code className="connector-page-code">notion\_append\_block\_children</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add content blocks (text, headings, lists, images, etc.) to an existing page or block. Use this after create\_page to add...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_block" data-action-label="Get Block" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Block</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_block" aria-label="Copy notion_get_block"><code className="connector-page-code">notion\_get\_block</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single block's type, content, and metadata by its block\_id (does NOT return children — use get\_block\_children...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_block_children" data-action-label="Get Block Children" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Block Children</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_block_children" aria-label="Copy notion_get_block_children"><code className="connector-page-code">notion\_get\_block\_children</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve the content blocks inside a page or parent block. This is how you read a page's actual content (text, headings,...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_update_block" data-action-label="Update Block" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Update Block</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_update_block" aria-label="Copy notion_update_block"><code className="connector-page-code">notion\_update\_block</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Modify an existing block's content (text, headings, to-dos, etc.) by block\_id. ALWAYS call this after reading blocks whe...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_delete_block" data-action-label="Delete Block" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Delete Block</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_delete_block" aria-label="Copy notion_delete_block"><code className="connector-page-code">notion\_delete\_block</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Archive (soft-delete) a block by its block\_id. The block is moved to trash, not permanently deleted — it can be restored...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_create_comment" data-action-label="Create Comment" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Create Comment</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_create_comment" aria-label="Copy notion_create_comment"><code className="connector-page-code">notion\_create\_comment</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a comment on a page or block, or reply to an existing discussion thread. Use the page\_id directly from create\_pag...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_list_comments" data-action-label="List Comments" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Comments</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_list_comments" aria-label="Copy notion_list_comments"><code className="connector-page-code">notion\_list\_comments</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List all unresolved comments on a page or block, with pagination. Resolved comments are excluded from results.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_retrieve_comment" data-action-label="Retrieve Comment" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Retrieve Comment</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_retrieve_comment" aria-label="Copy notion_retrieve_comment"><code className="connector-page-code">notion\_retrieve\_comment</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single comment's full details (content, author, timestamps, parent) by its comment\_id.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_create_database" data-action-label="Create Database" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Create Database</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_create_database" aria-label="Copy notion_create_database"><code className="connector-page-code">notion\_create\_database</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a new Notion database under a parent page, with an optional initial schema (columns/properties) defined via initi...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_database" data-action-label="Get Database" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Database</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_database" aria-label="Copy notion_get_database"><code className="connector-page-code">notion\_get\_database</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a database's metadata and its list of data sources (with IDs) by database\_id. Does NOT return rows — use query\_...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_update_database" data-action-label="Update Database" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Update Database</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_update_database" aria-label="Copy notion_update_database"><code className="connector-page-code">notion\_update\_database</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update database-level attributes (title, icon, cover, parent, archive status). To update columns/schema, use update\_data...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_create_data_source" data-action-label="Create Data Source" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Create Data Source</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_create_data_source" aria-label="Copy notion_create_data_source"><code className="connector-page-code">notion\_create\_data\_source</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Add a new data source (with its own schema/columns) to an existing database. Use this when a database needs multiple dat...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_retrieve_data_source" data-action-label="Retrieve Data Source" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Retrieve Data Source</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_retrieve_data_source" aria-label="Copy notion_retrieve_data_source"><code className="connector-page-code">notion\_retrieve\_data\_source</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a data source's schema (columns/properties) by its data\_source\_id. To get rows, use query\_data\_source instead....</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_update_data_source" data-action-label="Update Data Source" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Update Data Source</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_update_data_source" aria-label="Copy notion_update_data_source"><code className="connector-page-code">notion\_update\_data\_source</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update a data source's schema (add, rename, or remove columns), title, icon, or trash status. To update row values, use...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_query_data_source" data-action-label="Query Data Source" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Query Data Source</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_query_data_source" aria-label="Copy notion_query_data_source"><code className="connector-page-code">notion\_query\_data\_source</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Query a database's data source to retrieve rows (pages) with optional filtering and sorting. This is how you list or sea...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_list_data_source_templates" data-action-label="List Data Source Templates" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Data Source Templates</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_list_data_source_templates" aria-label="Copy notion_list_data_source_templates"><code className="connector-page-code">notion\_list\_data\_source\_templates</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List all page templates available for a data source, including each template's ID, name, and default status. Useful befo...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_create_file_upload" data-action-label="Create File Upload" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Create File Upload</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_create_file_upload" aria-label="Copy notion_create_file_upload"><code className="connector-page-code">notion\_create\_file\_upload</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Step 1 of file upload — create a file upload session to get an upload URL. Then call send\_file\_upload (step 2), and comp...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_send_file_upload" data-action-label="Send File Upload" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Send File Upload</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_send_file_upload" aria-label="Copy notion_send_file_upload"><code className="connector-page-code">notion\_send\_file\_upload</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Step 2 of file upload — send the actual file data for a file upload session created by create\_file\_upload. For multi\_par...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_complete_file_upload" data-action-label="Complete File Upload" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Complete File Upload</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_complete_file_upload" aria-label="Copy notion_complete_file_upload"><code className="connector-page-code">notion\_complete\_file\_upload</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Step 3 of multi\_part file upload only — finalize after all parts are sent via send\_file\_upload. Not needed for single\_pa...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_list_file_uploads" data-action-label="List File Uploads" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List File Uploads</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_list_file_uploads" aria-label="Copy notion_list_file_uploads"><code className="connector-page-code">notion\_list\_file\_uploads</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List all file uploads created by this bot integration, sorted most recent first. Filter by status (pending, uploaded, ex...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_retrieve_file_upload" data-action-label="Retrieve File Upload" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Retrieve File Upload</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_retrieve_file_upload" aria-label="Copy notion_retrieve_file_upload"><code className="connector-page-code">notion\_retrieve\_file\_upload</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single file upload's metadata and status (pending, uploaded, expired, failed) by its file\_upload\_id. Use afte...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_unified_get_me" data-action-label="Get Unified Credentials" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Unified Credentials</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_unified_get_me" aria-label="Copy notion_unified_get_me"><code className="connector-page-code">notion\_unified\_get\_me</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get the current Notion connection's unified credentials and identity.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_unified_list_organizations" data-action-label="List Unified Organizations" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Unified Organizations</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_unified_list_organizations" aria-label="Copy notion_unified_list_organizations"><code className="connector-page-code">notion\_unified\_list\_organizations</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified organizations in Notion.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_unified_get_organization" data-action-label="Get Unified Organization" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Unified Organization</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_unified_get_organization" aria-label="Copy notion_unified_get_organization"><code className="connector-page-code">notion\_unified\_get\_organization</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a unified Notion organization by ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_unified_list_users" data-action-label="List Unified Users" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Unified Users</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_unified_list_users" aria-label="Copy notion_unified_list_users"><code className="connector-page-code">notion\_unified\_list\_users</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List unified users in Notion.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_unified_get_user" data-action-label="Get Unified User" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Unified User</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_unified_get_user" aria-label="Copy notion_unified_get_user"><code className="connector-page-code">notion\_unified\_get\_user</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Get a unified Notion user by ID.</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_create_page" data-action-label="Create Page" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Create Page</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_create_page" aria-label="Copy notion_create_page"><code className="connector-page-code">notion\_create\_page</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Create a new page in a Notion workspace. After creation, the returned page object contains the new page\_id — use it dire...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_page" data-action-label="Get Page" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Page</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_page" aria-label="Copy notion_get_page"><code className="connector-page-code">notion\_get\_page</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a Notion page's properties and metadata by its page\_id (does NOT return page content — use get\_block\_children f...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_update_page" data-action-label="Update Page" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Update Page</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_update_page" aria-label="Copy notion_update_page"><code className="connector-page-code">notion\_update\_page</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Update page properties, icon, cover, or trash status by page ID. IMPORTANT — You must already have the page\_id; if you o...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_page_property" data-action-label="Get Page Property" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Page Property</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_page_property" aria-label="Copy notion_get_page_property"><code className="connector-page-code">notion\_get\_page\_property</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single page property value by page\_id and property\_id, with pagination support for large properties (title, r...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_move_page" data-action-label="Move Page" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Move Page</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_move_page" aria-label="Copy notion_move_page"><code className="connector-page-code">notion\_move\_page</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Move a page to a different parent page or database. THIS IS THE ONLY ACTION that can change a page's parent location — u...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_search" data-action-label="Search" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Search</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_search" aria-label="Copy notion_search"><code className="connector-page-code">notion\_search</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Search for pages and data sources by title text. Use this to find a page\_id when you only have a page name — required be...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_list_users" data-action-label="List Users" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>List Users</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_list_users" aria-label="Copy notion_list_users"><code className="connector-page-code">notion\_list\_users</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">List ALL users (people and bots) in the Notion workspace. Returns the complete set of workspace members across all pages...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_user" data-action-label="Get User" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get User</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_user" aria-label="Copy notion_get_user"><code className="connector-page-code">notion\_get\_user</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve a single Notion user's profile (name, email, avatar, type) by their user\_id. Get user IDs from list\_users resul...</div>
      </div>

      <div className="connector-meta-library-row" data-action-id="notion_get_bot_user" data-action-label="Get Bot User" data-action-scopes="">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Get Bot User</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_get_bot_user" aria-label="Copy notion_get_bot_user"><code className="connector-page-code">notion\_get\_bot\_user</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Retrieve the bot user (integration identity) associated with the current API token, including the workspace\_id and the p...</div>
      </div>
    </div>
  </div>
</div>

<div className="connector-meta-library-section">
  <div className="connector-meta-library-title">Events</div>

  <div className="connector-actions-controls not-prose" data-connector-events-controls>
    <div className="connector-actions-controls__row">
      <input type="search" className="connector-actions-search" data-connector-events-search placeholder="Search events" aria-label="Search events" />

      <div className="connector-actions-scopes" data-connector-events-scopes>
        <button type="button" className="connector-actions-scopes__toggle" data-connector-events-scopes-toggle aria-expanded="false">
          <span>Tags<span data-connector-events-scopes-count /></span>
        </button>

        <div className="connector-actions-scopes__menu">
          <div className="connector-actions-scopes__header">
            <input type="search" className="connector-actions-scopes__search" data-connector-events-scope-search placeholder="Search tags..." aria-label="Search tags" />

            <div className="connector-actions-scopes__actions">
              <button type="button" data-connector-events-scopes-select-all>Select all</button>
              <span>|</span>
              <button type="button" data-connector-events-scopes-clear>Clear</button>
            </div>
          </div>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="Comment" data-connector-events-scope-filter />

            <span>Comment</span>
          </label>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="Database" data-connector-events-scope-filter />

            <span>Database</span>
          </label>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="Page" data-connector-events-scope-filter />

            <span>Page</span>
          </label>

          <label className="connector-actions-scopes__item">
            <input type="checkbox" value="Verification" data-connector-events-scope-filter />

            <span>Verification</span>
          </label>

          <div className="connector-actions-scopes__empty" hidden>No tags found</div>
        </div>
      </div>
    </div>
  </div>

  <div className="meta-library-count" data-connector-events-count>9 events</div>

  <div className="not-prose meta-library-table-container" data-connector-events-table>
    <div className="connector-meta-library-grid" style={{ gridTemplateColumns: '200px 1fr 150px' }}>
      <div className="connector-meta-library-row">
        <div className="meta-library-grid-header-cell">Event</div>
        <div className="meta-library-grid-header-cell">Description</div>
        <div className="meta-library-grid-header-cell">Tags</div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_url_verification" data-event-label="URL Verification" data-event-tags="Verification">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>URL Verification</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_url_verification" aria-label="Copy notion_url_verification"><code className="connector-page-code">notion\_url\_verification</code></button></div>
          <div style={{ marginTop: '4px' }}><span className="connector-page-category-tag">Manual setup</span></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Handles Notion's one-time webhook verification challenge. Notion requires the verification\_token to be pasted back into...</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Verification</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_page_created" data-event-label="Page Created" data-event-tags="Page">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Page Created</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_page_created" aria-label="Copy notion_webhook_page_created"><code className="connector-page-code">notion\_webhook\_page\_created</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion page.created events when a new page is created.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Page</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_page_property_values_updated" data-event-label="Page Property Values Updated" data-event-tags="Page">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Page Property Values Updated</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_page_property_values_updated" aria-label="Copy notion_webhook_page_property_values_updated"><code className="connector-page-code">notion\_webhook\_page\_property\_values\_updated</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion page.property\_values.updated events when page properties are changed.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Page</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_page_content_updated" data-event-label="Page Content Updated" data-event-tags="Page">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Page Content Updated</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_page_content_updated" aria-label="Copy notion_webhook_page_content_updated"><code className="connector-page-code">notion\_webhook\_page\_content\_updated</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion page.content\_updated events when page content is changed. These events may be aggregated and delayed.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Page</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_database_created" data-event-label="Database Created" data-event-tags="Database">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Database Created</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_database_created" aria-label="Copy notion_webhook_database_created"><code className="connector-page-code">notion\_webhook\_database\_created</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion database.created events when a new database is created.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Database</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_database_schema_updated" data-event-label="Database Schema Updated" data-event-tags="Database">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Database Schema Updated</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_database_schema_updated" aria-label="Copy notion_webhook_database_schema_updated"><code className="connector-page-code">notion\_webhook\_database\_schema\_updated</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion database.schema\_updated events when a database schema is changed.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Database</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_comment_created" data-event-label="Comment Created" data-event-tags="Comment">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Comment Created</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_comment_created" aria-label="Copy notion_webhook_comment_created"><code className="connector-page-code">notion\_webhook\_comment\_created</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion comment.created events when a new comment is added to a page or discussion.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Comment</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_comment_updated" data-event-label="Comment Updated" data-event-tags="Comment">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Comment Updated</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_comment_updated" aria-label="Copy notion_webhook_comment_updated"><code className="connector-page-code">notion\_webhook\_comment\_updated</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion comment.updated events when an existing comment is modified.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Comment</span></div>
        </div>
      </div>

      <div className="connector-meta-library-row" data-event-id="notion_webhook_comment_deleted" data-event-label="Comment Deleted" data-event-tags="Comment">
        <div className="meta-library-grid-cell connector-meta-library-item-cell">
          <div style={{ fontWeight: '500' }}>Comment Deleted</div>
          <div style={{ marginTop: '4px' }}><button type="button" className="connector-page-code-button" data-copy="notion_webhook_comment_deleted" aria-label="Copy notion_webhook_comment_deleted"><code className="connector-page-code">notion\_webhook\_comment\_deleted</code></button></div>
        </div>

        <div className="meta-library-grid-cell meta-library-grid-cell--description">Processes Notion comment.deleted events when a comment is removed from a page or discussion.</div>

        <div className="meta-library-grid-cell meta-library-grid-cell--values">
          <div className="connector-meta-library-values-list"><span className="connector-page-category-tag">Comment</span></div>
        </div>
      </div>
    </div>
  </div>
</div>

## Getting Started

<Steps>
  <Step title="Create or Select a Project">
    Set up a new project or select an existing one. See the [Projects Guide](/guides/managing-projects).
  </Step>

  <Step title="Configure the Connector">
    Enable the connector and set up a connector profile in your project. See [Managing Connectors](/guides/explore-connectors).

    <Columns cols={2}>
      <Card title="Connector Profile" href="/connectors/notion/guides/connector-profile/installation-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Installation Access Token
      </Card>

      <Card title="Connector Profile" href="/connectors/notion/guides/connector-profile/personal-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Personal Access Token
      </Card>

      <Card title="Connector Profile" href="/connectors/notion/guides/connector-profile/oauth-2-0" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - OAuth 2.0
      </Card>
    </Columns>
  </Step>

  <Step title="Link an Account">
    Connect an account using [StackOne Hub](/guides/embedding-stackone-hub) or [Auth Link](/guides/auth-link).

    <Columns cols={2}>
      <Card title="Link Account" href="/connectors/notion/guides/link-account/installation-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Installation Access Token
      </Card>

      <Card title="Link Account" href="/connectors/notion/guides/link-account/personal-access-token" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - Personal Access Token
      </Card>

      <Card title="Link Account" href="/connectors/notion/guides/link-account/oauth-2-0" icon="https://stackone-logos.com/api/notion/filled/png" horizontal>
        Notion - OAuth 2.0
      </Card>
    </Columns>
  </Step>

  <Step title="Use Actions">
    Invoke actions using one of the methods below:

    * [MCP](/mcp/quickstart) – Model Context Protocol for AI assistants
    * [A2A](/a2a/quickstart) – Agent-to-Agent protocol
    * [AI Toolset (TypeScript)](/agents/typescript/introduction) – TypeScript SDK for AI agents
    * [AI Toolset (Python)](/agents/python/introduction) – Python SDK for AI agents
    * [Actions RPC](/platform/api-reference/actions/make-an-rpc-call-to-an-action) – Direct API calls
    * [Playground](/guides/playground) – Test actions in the dashboard
  </Step>
</Steps>

## Webhook Events

<Columns cols={2}>
  <Card title="Webhooks setup" href="/connectors/notion/guides/webhook-setup">
    <p className="connector-page-auth-description" style={{ fontSize: '14px', marginTop: 0, marginBottom: 0 }}>
      Configure receiving Events for Notion into StackOne.
    </p>
  </Card>
</Columns>