Prerequisites
- A Notion account
- Access to create integrations in your Notion workspace
Creating a Notion Integration
- Visit the Notion Developers page
- Click “New integration”
- Fill in the required information:
- Name: A name for your integration
- Associated workspace: Select your Notion workspace
- Description: Brief description of your integration
- Click “Submit”
Configuring Your Notion Integration
Basic Settings
- In your integration settings, note your Internal Integration Token (you’ll need this later)
- Add a description and icon for your integration
- Configure the integration’s capabilities
Capabilities
Your integration can have the following capabilities:- Read content - Read pages and databases
- Update content - Update existing pages and databases
- Insert content - Create new pages and databases
- Create comments - Add comments to pages
- Read user information - Access user data
Setting Up in Jinba Flow
- Go to your workspace settings in Jinba Flow
- Navigate to the “Secret” section
- Find “Notion” in the list of available credentials
- Click “Configure” or “Add New”
- Enter your Notion integration credentials:
- Internal Integration Token: From your Notion integration settings
- Database ID: The ID of your target database (optional)
- Page ID: The ID of your target page (optional)
- Click “Save” to store your credentials
Sharing Pages with Your Integration
For your integration to access Notion pages and databases:- Open the page or database you want to share
- Click the “Share” button in the top right
- Click “Invite” and search for your integration name
- Select your integration and click “Invite”
- Choose the appropriate permissions (Read, Edit, etc.)
Usage
Once configured, you can use Notion in your flows to:- Create new pages and databases
- Update existing pages and databases
- Read page content and database entries
- Add comments to pages
- Search for pages and databases
- Manage page properties and metadata
Page and Database Operations
Creating Content
- Create pages with various content types
- Create databases with custom properties
- Add blocks (text, images, tables, etc.)
- Set page properties (title, tags, dates, etc.)
Reading Content
- Get page content and structure
- Query databases with filters
- Search pages across your workspace
- Get user information
Updating Content
- Update page properties
- Modify page content
- Update database entries
- Add comments