OneNote

Configuration

Microsoft OneNote source connector integrates with the Microsoft Graph API.

Synchronizes data from Microsoft OneNote including notebooks, sections, and pages.

It provides comprehensive access to OneNote resources with proper token refresh and rate limiting.

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:

OneNoteNotebookEntity

Schema for a Microsoft OneNote notebook.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/notebook

Field	Type	Description
id	str	Notebook ID.
display_name	str	The name of the notebook.
is_default	Optional[bool]	Indicates whether this is the user's default notebook.
is_shared	Optional[bool]	Indicates whether the notebook is shared with other users.
user_role	Optional[str]	The current user's role in the notebook (Owner, Contributor, Reader).
created_by	Optional[Dict[str, Any]]	Identity of the user who created the notebook.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the notebook.
links	Optional[Dict[str, Any]]	Links for opening the notebook.
self_url	Optional[str]	The endpoint URL where you can get details about the notebook.
web_url_override	Optional[str]	Direct URL to open the notebook in OneNote.

OneNoteSectionGroupEntity

Schema for a Microsoft OneNote section group.

Section groups are containers that can hold sections and other section groups.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/sectiongroup

Field	Type	Description
notebook_id	str	ID of the notebook this section group belongs to.
parent_section_group_id	Optional[str]	ID of the parent section group, if nested.
display_name	str	The name of the section group.
created_by	Optional[Dict[str, Any]]	Identity of the user who created the section group.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the section group.
sections_url	Optional[str]	The endpoint URL where you can get all the sections in the section group.
section_groups_url	Optional[str]	The endpoint URL where you can get all the section groups nested in this section group.

OneNoteSectionEntity

Schema for a Microsoft OneNote section.

Sections contain pages and can belong to a notebook or section group.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/section

Field	Type	Description
notebook_id	str	ID of the notebook this section belongs to.
parent_section_group_id	Optional[str]	ID of the parent section group, if any.
id	str	Section ID.
display_name	str	The name of the section.
is_default	Optional[bool]	Indicates whether this is the user's default section.
created_by	Optional[Dict[str, Any]]	Identity of the user who created the section.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the section.
pages_url	Optional[str]	The endpoint URL where you can get all the pages in the section.
web_url_override	Optional[str]	Direct URL to open the section.

OneNotePageFileEntity

Schema for a Microsoft OneNote page as a file entity.

Pages are the actual content containers in OneNote. Extends FileEntity to leverage Graffo's HTML processing pipeline.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/onenotepage

Field	Type	Description
id	str	Page ID.
notebook_id	str	ID of the notebook this page belongs to.
section_id	str	ID of the section this page belongs to.
title	str	The title of the page.
content_url	Optional[str]	The URL for the page's HTML content.
level	Optional[int]	The indentation level of the page (for hierarchical pages).
order	Optional[int]	The order of the page within its parent section.
created_by	Optional[Dict[str, Any]]	Identity of the user who created the page.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the page.
links	Optional[Dict[str, Any]]	Links for opening the page in OneNote client or web.
user_tags	Optional[List[str]]	User-defined tags associated with the page.
web_url_override	Optional[str]	Direct URL to open the page in OneNote.