Notion

Configuration

Notion source connector integrates with the Notion API to extract and synchronize content.

Connects to your Notion workspace.

It provides comprehensive access to databases, pages, and content with advanced content aggregation, lazy loading, and file processing capabilities for optimal performance.

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Graffo UI or API using the OAuth flow.

Supported authentication methods:

• OAuth Browser Flow (recommended for UI)

• OAuth Token (for programmatic access)

• Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

NotionDatabaseEntity

Schema for a Notion database.

Field	Type	Description
database_id	str	The ID of the database.
title	str	The title of the database
created_time	Optional[datetime]	When the database was created.
updated_time	Optional[datetime]	When the database was last edited.
description	str	The description of the database
properties	Dict[str, Any]	Database properties schema
properties_text	Optional[str]	Human-readable schema description
parent_id	str	The ID of the parent
parent_type	str	The type of the parent (workspace, page_id, etc.)
icon	Optional[Dict[str, Any]]	The icon of the database
cover	Optional[Dict[str, Any]]	The cover of the database
archived	bool	Whether the database is archived
is_inline	bool	Whether the database is inline
url	str	The URL of the database

NotionPageEntity

Schema for a Notion page with aggregated content.

Field	Type	Description
page_id	str	The ID of the page.
parent_id	str	The ID of the parent
parent_type	str	The type of the parent (workspace, page_id, database_id, etc.)
title	str	The title of the page
created_time	Optional[datetime]	When the page was created.
updated_time	Optional[datetime]	When the page was last edited.
content	Optional[str]	Full aggregated content
properties	Dict[str, Any]	Formatted page properties for search
properties_text	Optional[str]	Human-readable properties text
property_entities	List[Any]	Structured property entities
files	List[Any]	Files referenced in the page
icon	Optional[Dict[str, Any]]	The icon of the page
cover	Optional[Dict[str, Any]]	The cover of the page
archived	bool	Whether the page is archived
in_trash	bool	Whether the page is in trash
url	str	The URL of the page
content_blocks_count	int	Number of blocks processed
max_depth	int	Maximum nesting depth of blocks

NotionPropertyEntity

Schema for a Notion database page property.

Field	Type	Description
property_key	str	Stable unique identifier for the property entity.
property_id	str	The ID of the property
property_name	str	The name of the property
property_type	str	The type of the property
page_id	str	The ID of the page this property belongs to
database_id	str	The ID of the database this property belongs to
value	Optional[Any]	The raw value of the property
formatted_value	str	The formatted/display value of the property

NotionFileEntity

Schema for a Notion file.

Reference: https://developers.notion.com/reference/file-object

Field	Type	Description
file_id	str	ID of the file in Notion
file_name	str	Display name of the file
expiry_time	Optional[datetime]	When the file URL expires (for Notion-hosted files)
caption	str	The caption of the file
web_url_value	Optional[str]	Link to view/download the file.