- OAuth2 authentication (via VibeFlow Cloud or your own credentials via BYOK)
BYOK (Bring Your Own Keys)
If you prefer to use your own Notion OAuth credentials instead of VibeFlow’s managed OAuth, follow these steps:Create a Notion Integration
Go to notion.so/my-integrations and click New integration.Fill in the basic information (name, logo, associated workspace, etc.).
Configure Capabilities
Under Capabilities, enable the following:
- Read content
- Update content
- Insert content
Set Integration Type and Redirect URI
Set the integration type to Public.Add the following OAuth Redirect URI:
BYOK is ideal for businesses that require data isolation, custom branding, or stricter compliance requirements.
Available Endpoints
Database Operations
POST /api/actions/notion/databases
POST /api/actions/notion/databases
Create a new database in a Notion workspace.
GET /api/actions/notion/databases/{databaseId}
GET /api/actions/notion/databases/{databaseId}
Retrieve a specific database by ID.
POST /api/actions/notion/databases/{databaseId}/query
POST /api/actions/notion/databases/{databaseId}/query
Query a database with filters and sorting options.
POST /api/actions/notion/databases/search
POST /api/actions/notion/databases/search
Search across all databases in your Notion workspace.
Page Operations
GET /api/actions/notion/pages/{pageId}
GET /api/actions/notion/pages/{pageId}
Retrieve a specific page by ID.
POST /api/actions/notion/pages
POST /api/actions/notion/pages
Create a new page in a workspace or database.
PATCH /api/actions/notion/pages/{pageId}
PATCH /api/actions/notion/pages/{pageId}
Update the properties of an existing page.
DELETE /api/actions/notion/pages/{pageId}
DELETE /api/actions/notion/pages/{pageId}
Archive a page by ID.
POST /api/actions/notion/pages/search
POST /api/actions/notion/pages/search
Search across all pages in your Notion workspace.
Block Operations
GET /api/actions/notion/blocks/{blockId}
GET /api/actions/notion/blocks/{blockId}
Retrieve a specific block by ID.
GET /api/actions/notion/blocks/{blockId}/children
GET /api/actions/notion/blocks/{blockId}/children
Retrieve all children blocks of a given block.
PATCH /api/actions/notion/blocks/{blockId}/children
PATCH /api/actions/notion/blocks/{blockId}/children
Append new children blocks to an existing block.
PATCH /api/actions/notion/blocks/{blockId}
PATCH /api/actions/notion/blocks/{blockId}
Update the content or properties of an existing block.
DELETE /api/actions/notion/blocks/{blockId}
DELETE /api/actions/notion/blocks/{blockId}
Delete a block by ID.

