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

# Notion

> Read, write, and manage Notion pages and databases

Notion integration for reading, creating, and updating pages and databases in your Notion workspace.

**Required Configuration:**

* OAuth2 authentication. Connect your Notion account via the OAuth flow in the VibeFlow Connectors settings.

## Setting Up Notion

<Steps>
  <Step title="Open Connectors">
    Go to **Settings** > **Connectors** in your VibeFlow dashboard and select **Notion**.
  </Step>

  <Step title="Authorize Access">
    Follow the OAuth flow to connect your Notion workspace. You'll be asked to select which pages and databases VibeFlow can access.
  </Step>

  <Step title="Use in Workflows">
    Once connected, use Notion in your workflows to read, create, and update pages and databases.
  </Step>
</Steps>

## Available Endpoints

### Database Operations

<AccordionGroup>
  <Accordion title="POST /api/actions/notion/databases">
    Create a new database in a Notion workspace.
  </Accordion>

  <Accordion title="GET /api/actions/notion/databases/{databaseId}">
    Retrieve a specific database by ID.
  </Accordion>

  <Accordion title="POST /api/actions/notion/databases/{databaseId}/query">
    Query a database with filters and sorting options.
  </Accordion>

  <Accordion title="POST /api/actions/notion/databases/search">
    Search across all databases in your Notion workspace.
  </Accordion>
</AccordionGroup>

### Page Operations

<AccordionGroup>
  <Accordion title="GET /api/actions/notion/pages/{pageId}">
    Retrieve a specific page by ID.
  </Accordion>

  <Accordion title="POST /api/actions/notion/pages">
    Create a new page in a workspace or database.
  </Accordion>

  <Accordion title="PATCH /api/actions/notion/pages/{pageId}">
    Update the properties of an existing page.
  </Accordion>

  <Accordion title="DELETE /api/actions/notion/pages/{pageId}">
    Archive a page by ID.
  </Accordion>

  <Accordion title="POST /api/actions/notion/pages/search">
    Search across all pages in your Notion workspace.
  </Accordion>
</AccordionGroup>

### Block Operations

<AccordionGroup>
  <Accordion title="GET /api/actions/notion/blocks/{blockId}">
    Retrieve a specific block by ID.
  </Accordion>

  <Accordion title="GET /api/actions/notion/blocks/{blockId}/children">
    Retrieve all children blocks of a given block.
  </Accordion>

  <Accordion title="PATCH /api/actions/notion/blocks/{blockId}/children">
    Append new children blocks to an existing block.
  </Accordion>

  <Accordion title="PATCH /api/actions/notion/blocks/{blockId}">
    Update the content or properties of an existing block.
  </Accordion>

  <Accordion title="DELETE /api/actions/notion/blocks/{blockId}">
    Delete a block by ID.
  </Accordion>
</AccordionGroup>