Skip to content
Book a demoStart free
Connectors

Notion connector

Set up the Notion connector in Kaivo: authentication, configuration, the 5 BigQuery tables it syncs, and answers to common questions.

Notion connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your Notion data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your project management data instead of moving it.

Sync your Notion pages, databases, and comments into BigQuery with Kaivo to report on the content and work your team tracks in Notion alongside your data.

CategoryProject Management, Files & Databases
AuthenticationAPI key
SetupSelf-service
  1. Sign up for Kaivo and create a workspace.
  2. Connect your Notion account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your Access Token.

Field Description
Access Token
Access token for your private Notion integration.

|

When you set up the connector, you provide:

Field Description
Start Date
Any data before this date will not be fetched.

|

Kaivo syncs 5 tables from Notion into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

blocks (83 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
object JSON Represents an object block.
parent__type JSON
parent__block_id STRING
parent__data_source_id STRING
parent__database_id STRING
parent__page_id STRING
parent__workspace BOOL
parent__sequence_number INT64 The sequence number of a given block within the parent block.
id STRING The unique identifier of the block.
created_time TIMESTAMP The timestamp when the block was created.
created_by__object JSON
created_by__id STRING
created_by__name STRING
created_by__avatar_url STRING
created_by__type JSON
created_by__person__email STRING
created_by__bot__owner__type STRING
created_by__bot__owner__info JSON
created_by__bot__owner__workspace BOOL
created_by__bot__workspace_name STRING
last_edited_by__object JSON
last_edited_by__id STRING
last_edited_by__name STRING
last_edited_by__avatar_url STRING
last_edited_by__type JSON
last_edited_by__person__email STRING
last_edited_by__bot__owner__type STRING
last_edited_by__bot__owner__info JSON
last_edited_by__bot__owner__workspace BOOL
last_edited_by__bot__workspace_name STRING
last_edited_time TIMESTAMP The timestamp when the block was last edited.
archived BOOL Indicates if the block is archived or not.
in_trash BOOL Indicates whether the block is in trash or not.
has_children BOOL Indicates if the block has children or not.
type JSON The type of the block.
bookmark__url STRING The URL of the bookmark.
bulleted_list_item__color STRING
callout__color STRING The color of the callout element.
callout__icon JSON The icon associated with the callout.
child_page__title STRING
child_database__title STRING
code__language JSON The programming language used in the code block.
embed__url STRING The URL of the embedded content.
equation__expression STRING The mathematical expression in the block.
file__type JSON
file__external__url STRING
file__file__url STRING
file__file__expiry_time TIMESTAMP
heading_1__color STRING
heading_1__is_toggleable BOOL
heading_2__color STRING
heading_2__is_toggleable BOOL
heading_3__color STRING
heading_3__is_toggleable BOOL
image__type JSON
image__external__url STRING
image__file__url STRING
image__file__expiry_time TIMESTAMP
link_preview__url STRING The URL of the link preview.
link_to_page__page_id STRING The ID of the linked page.
link_to_page__type STRING The type of the linked page.
numbered_list_item__color STRING
paragraph__color STRING
pdf__type JSON
pdf__external__url STRING
pdf__file__url STRING
pdf__file__expiry_time TIMESTAMP
quote__color STRING
synced_block__synced_from__type STRING The type of the block synced from.
synced_block__synced_from__block_id STRING The ID of the block synced from.
table__table_width INT64 The width of the table.
table__has_column_header BOOL Indicates if the table has column headers.
table__has_row_header BOOL Indicates if the table has row headers.
table_of_contents__color STRING The color of the table of contents.
to_do__checked BOOL Indicates if the to-do item is checked.
to_do__color STRING The color associated with the to-do item.
toggle__color STRING
video__type JSON
video__external__url STRING
video__file__url STRING
video__file__expiry_time TIMESTAMP
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: blocks__bulleted_list_item__rich_text

Section titled “Subtable: blocks__bulleted_list_item__rich_text”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: blocks__bulleted_list_item__children

Section titled “Subtable: blocks__bulleted_list_item__children”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: blocks__numbered_list_item__rich_text

Section titled “Subtable: blocks__numbered_list_item__rich_text”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: blocks__numbered_list_item__children

Section titled “Subtable: blocks__numbered_list_item__children”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
comments (20 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
object JSON The object to which the comment is related.
id STRING The unique identifier of the comment.
parent__type JSON The type of the parent object.
parent__page_id STRING The unique identifier of the parent page.
discussion_id STRING The unique identifier of the discussion where the comment belongs.
created_time TIMESTAMP The timestamp when the comment was created.
last_edited_time TIMESTAMP The timestamp when the comment was last edited.
page_last_edited_time TIMESTAMP The timestamp when the page was last edited.
created_by__object JSON
created_by__id STRING
created_by__name STRING
created_by__avatar_url STRING
created_by__type JSON
created_by__person__email STRING
created_by__bot__owner__type STRING
created_by__bot__owner__info JSON
created_by__bot__owner__workspace BOOL
created_by__bot__workspace_name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING The type of text.
text__content STRING The content of the text.
annotations__bold BOOL Indicates if the text is formatted as bold.
annotations__italic BOOL Indicates if the text is formatted as italic.
annotations__strikethrough BOOL Indicates if the text is formatted with strikethrough.
annotations__underline BOOL Indicates if the text is underlined.
annotations__code BOOL Indicates if the text is formatted as code.
annotations__color STRING The color of the text.
plain_text STRING The plain text content.
href STRING The hyperlink reference.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
data_sources (46 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
object JSON The type of object represented by the data source.
id STRING Unique identifier of the data source.
name STRING The name of the data source.
created_time TIMESTAMP The timestamp when the data source was created.
last_edited_time TIMESTAMP The timestamp when the data source was last edited.
in_trash BOOL Indicates whether the data source is in trash or not.
last_edited_by__object JSON
last_edited_by__id STRING
last_edited_by__name STRING
last_edited_by__avatar_url STRING
last_edited_by__type JSON
last_edited_by__person__email STRING
last_edited_by__bot__owner__type STRING
last_edited_by__bot__owner__info JSON
last_edited_by__bot__owner__workspace BOOL
last_edited_by__bot__workspace_name STRING
created_by__object JSON
created_by__id STRING
created_by__name STRING
created_by__avatar_url STRING
created_by__type JSON
created_by__person__email STRING
created_by__bot__owner__type STRING
created_by__bot__owner__info JSON
created_by__bot__owner__workspace BOOL
created_by__bot__workspace_name STRING
archived BOOL Indicates if the data is archived or not.
icon JSON URL or reference to the icon of the database.
cover__type JSON
cover__external__url STRING
cover__file__url STRING
cover__file__expiry_time TIMESTAMP
parent__type JSON
parent__database_id STRING
database_parent__type JSON
database_parent__block_id STRING
database_parent__page_id STRING
database_parent__workspace BOOL
url STRING URL or reference to access the data source.
is_inline BOOL Indicates if the database is displayed inline.
public_url STRING Public URL to access the data source.
unique_id__prefix STRING
workspace_name STRING The name of the workspace containing the data source.
is_locked BOOL Indicates whether the data source schema is locked.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
name STRING The name of the property.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
pages (41 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
object JSON Type or category of the page object.
id STRING Unique identifier of the page.
created_time TIMESTAMP Date and time when the page was created.
created_by__object JSON
created_by__id STRING
created_by__name STRING
created_by__avatar_url STRING
created_by__type JSON
created_by__person__email STRING
created_by__bot__owner__type STRING
created_by__bot__owner__info JSON
created_by__bot__owner__workspace BOOL
created_by__bot__workspace_name STRING
last_edited_time TIMESTAMP Date and time when the page was last edited.
last_edited_by__object JSON
last_edited_by__id STRING
last_edited_by__name STRING
last_edited_by__avatar_url STRING
last_edited_by__type JSON
last_edited_by__person__email STRING
last_edited_by__bot__owner__type STRING
last_edited_by__bot__owner__info JSON
last_edited_by__bot__owner__workspace BOOL
last_edited_by__bot__workspace_name STRING
archived BOOL Indicates whether the page is archived or not.
in_trash BOOL Indicates whether the page is in trash or not.
icon JSON URL or reference to the page icon.
cover__type JSON
cover__external__url STRING
cover__file__url STRING
cover__file__expiry_time TIMESTAMP
parent__type JSON
parent__block_id STRING
parent__data_source_id STRING
parent__database_id STRING
parent__page_id STRING
parent__workspace BOOL
url STRING URL of the page within the service.
public_url STRING Publicly accessible URL of the page.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
text__content STRING
text__link__type JSON
text__link__url STRING
mention__type STRING
mention__info__id STRING
mention__info__object STRING
equation__expression STRING
annotations__bold BOOL
annotations__italic BOOL
annotations__strikethrough BOOL
annotations__underline BOOL
annotations__code BOOL
annotations__color STRING
plain_text STRING
href STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
name STRING Name or key of the custom property.
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
users (12 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
object JSON
id STRING
name STRING
avatar_url STRING
type JSON
person__email STRING
bot__owner__type STRING
bot__owner__info JSON
bot__owner__workspace BOOL
bot__workspace_name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Notion supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for Notion?

Section titled “How long does the initial sync take for Notion?”

It depends on how much history is in your Notion account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when Notion’s schema changes?

Section titled “What happens when Notion’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Notion, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Notion instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Notion connector in Kaivo and all of its synced data is deleted with it.

Turn the pages and databases your team maintains in Notion into dashboards and metrics.

Analyse Notion databases used for tasks or projects to monitor status and progress.

Report on pages and blocks to keep an inventory of documentation and find gaps.

Join Notion data with your other tools in BigQuery for a full picture.

Once Notion data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Notion data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Notion connector pricing and plan details.