DocsConnectors

Onenote

Onenote logo

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.

View Source Code

Explore the Onenote connector implementation

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Airweave 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:

Schema for a Microsoft OneNote notebook.

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

FieldTypeDescription
display_namestrThe name of the notebook.
is_defaultOptional[bool]Indicates whether this is the user’s default notebook.
is_sharedOptional[bool]Indicates whether the notebook is shared with other users.
user_roleOptional[str]The current user’s role in the notebook (Owner, Contributor, Reader).
created_byOptional[Dict[str, Any]]Identity of the user who created the notebook.
last_modified_byOptional[Dict[str, Any]]Identity of the user who last modified the notebook.
linksOptional[Dict[str, Any]]Links for opening the notebook.
self_urlOptional[str]The endpoint URL where you can get details about the notebook.

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

FieldTypeDescription
notebook_idstrID of the notebook this section group belongs to.
parent_section_group_idOptional[str]ID of the parent section group, if nested.
display_namestrThe name of the section group.
created_byOptional[Dict[str, Any]]Identity of the user who created the section group.
last_modified_byOptional[Dict[str, Any]]Identity of the user who last modified the section group.
sections_urlOptional[str]The endpoint URL where you can get all the sections in the section group.
section_groups_urlOptional[str]The endpoint URL where you can get all the section groups nested in this section group.

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

FieldTypeDescription
notebook_idstrID of the notebook this section belongs to.
parent_section_group_idOptional[str]ID of the parent section group, if any.
display_namestrThe name of the section.
is_defaultOptional[bool]Indicates whether this is the user’s default section.
created_byOptional[Dict[str, Any]]Identity of the user who created the section.
last_modified_byOptional[Dict[str, Any]]Identity of the user who last modified the section.
pages_urlOptional[str]The endpoint URL where you can get all the pages in the section.

Schema for a Microsoft OneNote page as a file entity.

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

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

FieldTypeDescription
notebook_idstrID of the notebook this page belongs to.
section_idstrID of the section this page belongs to.
titlestrThe title of the page.
content_urlOptional[str]The URL for the page’s HTML content.
levelOptional[int]The indentation level of the page (for hierarchical pages).
orderOptional[int]The order of the page within its parent section.
created_byOptional[Dict[str, Any]]Identity of the user who created the page.
last_modified_byOptional[Dict[str, Any]]Identity of the user who last modified the page.
linksOptional[Dict[str, Any]]Links for opening the page in OneNote client or web.
user_tagsOptional[List[str]]User-defined tags associated with the page.