Notion Tables

The Notion integration uses the following tables

Tables

NotionUsers

Contains Notion user account records including user type, display name, avatar URL, and for workspace members, their email address and workspace role.

NameTypeDescription
UserIDstringNotion user UUID. Part of the composite primary key (UserID + ConfigID).
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
ObjectTypestringNotion object type (always user).
TypestringUser type: person or bot.
NamestringDisplay name of the user.
AvatarURLstringURL of the user's avatar image.
PersonEmailstringEmail address for person-type users (from person.email).
BotOwnerTypestringBot owner type (from bot.owner.type): workspace or user.
BotWorkspaceNamestringBot workspace name (from bot.workspace_name); populated when the bot belongs to a workspace.
BatchDatedatetimeTimestamp indicating when the record was ingested or last refreshed.

NotionPages

Stores Notion page records including the page title, URL, parent reference (page, database, or workspace), archived state, and creation and last edit timestamps.

NameTypeDescription
PageIDstringNotion page UUID. Part of the composite primary key (PageID + ConfigID).
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
ObjectTypestringNotion object type (always page).
CreatedTimedatetimeISO 8601 creation timestamp.
LastEditedTimedatetimeISO 8601 last-edit timestamp.
CreatedByIDstringNotion UUID of the user who created the page (from created_by.id).
LastEditedByIDstringNotion UUID of the user who last edited the page (from last_edited_by.id).
ParentTypestringParent object type (e.g. workspace page_id database_id).
ParentIDstringUUID of the parent object when ParentType is page database or block.
ArchivedbooleanWhether the page is archived.
InTrashbooleanWhether the page is in the workspace trash.
URLstringNotion web URL for the page.

NotionDatabases

Contains Notion database records including the database title, description, URL, property schema definitions, and parent page reference.

NameTypeDescription
DatabaseIDstringNotion database UUID. Part of the composite primary key (DatabaseID + ConfigID).
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
ObjectTypestringNotion object type (always database).
CreatedTimedatetimeISO 8601 creation timestamp.
LastEditedTimedatetimeISO 8601 last-edit timestamp.
CreatedByIDstringNotion UUID of the user who created the database (from created_by.id).
LastEditedByIDstringNotion UUID of the user who last edited the database (from last_edited_by.id).
TitlePlainTextstringPlain-text concatenation of the database title rich-text array.
DescriptionPlainTextstringPlain-text concatenation of the database description rich-text array.
ParentTypestringParent object type (e.g. workspace page_id).
ParentIDstringUUID of the parent object when ParentType is page or block.
ArchivedbooleanWhether the database is archived.

NotionDatabaseRows

Stores row (page) records within Notion databases, capturing the property values for each row as defined by the parent database schema, along with the row's title, URL, and creation metadata.

NameTypeDescription
RowIDstringNotion page UUID identifying this database row. Part of the composite primary key (RowID + ConfigID).
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
DatabaseIDstringUUID of the database this row belongs to.
CreatedTimedatetimeISO 8601 creation timestamp.
LastEditedTimedatetimeISO 8601 last-edit timestamp.
CreatedByIDstringNotion UUID of the user who created the row (from created_by.id).
LastEditedByIDstringNotion UUID of the user who last edited the row (from last_edited_by.id).
ArchivedbooleanWhether the row is archived.
InTrashbooleanWhether the row is in the workspace trash.
URLstringNotion web URL for this row/page.
PropertiesJsonstringSerialized JSON of the row's property values keyed by column name.
BatchDatedatetimeTimestamp indicating when the record was ingested or last refreshed.

NotionBlocks

Stores individual block records from Notion pages and databases, representing the atomic content units such as paragraphs, headings, lists, code blocks, and embeds, including their type, parent reference, and archived state.

NameTypeDescription
BlockIDstringNotion block UUID. Part of the composite primary key (BlockID + ParentPageID + ParentBlockID + ConfigID).
ParentPageIDstringUUID of the top-level page that owns this block. Part of the composite primary key.
ParentBlockIDstringUUID of the direct parent block when nested; empty string when the parent is a page. Part of the composite primary key.
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
ObjectTypestringNotion object type (always block).
TypestringBlock type string (e.g. paragraph, heading_1, to_do).
CreatedTimedatetimeISO 8601 creation timestamp.
LastEditedTimedatetimeISO 8601 last-edit timestamp.
HasChildrenbooleanWhether this block has nested children that were recursively fetched.
ArchivedbooleanWhether the block is archived.
InTrashbooleanWhether the block is in the workspace trash.
PlainTextstringBest-effort plain-text extraction from the block's rich-text content.
ContentJsonstringSerialized JSON of the type-specific block content object.
BatchDatedatetimeTimestamp indicating when the record was ingested or last refreshed.

NotionComments

Contains comment records added to Notion pages and blocks, including the comment body (rich text), author identity, parent block or page reference, and creation and last edit timestamps.

NameTypeDescription
CommentIDstringNotion comment UUID. Part of the composite primary key (CommentID + ConfigID).
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
DiscussionIDstringDiscussion thread UUID this comment belongs to.
ParentTypestringParent object type (e.g. page_id or block_id).
ParentIDstringUUID of the parent page or block.
CreatedTimedatetimeISO 8601 creation timestamp.
LastEditedTimedatetimeISO 8601 last-edit timestamp.
CreatedByIDstringNotion UUID of the comment author (from created_by.id).
RichTextPlainTextstringPlain-text concatenation of the comment rich-text array.
ContentJsonstringSerialized JSON of the full rich-text array.
BatchDatedatetimeTimestamp indicating when the record was ingested or last refreshed.

NotionLegalHolds

Contains Notion Legal Hold records that preserve content from deletion or modification, including the hold name, status, creation details, and the scope of content covered.

NameTypeDescription
LegalHoldIDstringNotion legal hold UUID. Part of the composite primary key (LegalHoldID + ConfigID). Sourced from Admin API (Enterprise only).
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
NamestringDisplay name of the legal hold.
DescriptionstringDescription of the legal hold.
IconstringIcon identifier for the legal hold.
StatusstringLegal hold status: active or released.
CreatedBystringUUID of the user who created the legal hold (from created_by).
CreatedTimeintegerUnix epoch timestamp when the legal hold was created.
StartDateintegerUnix epoch timestamp for the legal hold start date.
EndDateintegerUnix epoch timestamp for the legal hold end date; null if not set.
UsersTotalintegerTotal number of users on the legal hold (from users.total).
UserIDsSerializedstringSerialized JSON array of user UUIDs on the legal hold (from users.ids).
WorkspacesTotalintegerTotal number of workspaces on the legal hold (from workspaces.total).
UserInteractionTypeSerializedstringSerialized JSON array of interaction type strings tracked by the legal hold (e.g. [page.created, page.edited]).
BatchDatedatetimeTimestamp indicating when the record was ingested or last refreshed.

NotionLegalHoldWorkspaces

Stores workspace-level records associated with Notion Legal Hold configurations, linking legal hold policies to the workspaces they are applied to.

NameTypeDescription
LegalHoldIDstringUUID of the legal hold this workspace is associated with. Part of the composite primary key (LegalHoldID + WorkspaceID + ConfigID). Sourced from Admin API (Enterprise only).
WorkspaceIDstringUUID of the workspace on the legal hold. Part of the composite primary key.
ConfigIDintegerIdentifier linking the record to a specific Notion integration configuration.
BatchDatedatetimeTimestamp indicating when the record was ingested or last refreshed.


Did this page help you?