Add Microsoft OneNote to your AI agent

Retrieves a specific section group from a OneNote notebook within a Microsoft 365 group. Use this action when you need to get details about a specific section group, including its name, creation/modification timestamps, and links to its sections and nested section groups.

Retrieves OneNote page metadata directly by page ID in a Microsoft 365 group. Legacy notebook, section group, and section IDs do not affect the Graph route.

Retrieves metadata and properties of a specific OneNote page from the authenticated user's notebooks. Use this action when you need to fetch details about a OneNote page by its ID without navigating the full notebook/section hierarchy. This returns page metadata including title, creation date, modification date, and optional expanded parent relationships. For retrieving the HTML content of a page, use the dedicated page content endpoint instead.

Retrieves a list of recently accessed OneNote notebooks for the signed-in user. Use this action when you need to display recently accessed notebooks, provide quick access to notebooks the user has been working with, or build a recent notebooks feature. The notebooks are returned in order of most recent access. Set includePersonalNotebooks to true to include notebooks owned by the user, or false to exclude them.

Retrieves a specific OneNote section by its ID from the current user's OneNote. Use this action when you need to fetch metadata or details for a single OneNote section by specifying only the section ID, without requiring additional context like group, user, or site IDs. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Retrieves a specific OneNote section from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the site ID and section ID. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Compatibility alias for retrieving OneNote page metadata directly by page ID in a SharePoint site. Prefer GetSiteOnenotePages for new calls. Legacy notebook, section group, and section IDs do not affect the Graph route.

Retrieves the properties and relationships of a OneNote notebook by ID for a specific user. Use this action when you need to fetch details about a specific notebook belonging to a user, including its display name, sharing status, section URLs, and the user's role on the notebook. Supports OData $select and $expand query parameters to customize the response.

Retrieves a specific OneNote page from a user's OneNote notebooks. Use this action when you need to fetch metadata or details for a single OneNote page directly by page ID and user ID. This is useful for retrieving page information without navigating through the full notebook/section hierarchy. The default response expands the parentSection relationship and selects its id, name, and self properties.

Retrieves the parent section group of a OneNote section within a user's notebook. Use this action when you need to navigate up the OneNote hierarchy from a section to its parent section group, for example to determine which section group contains a specific section.

Retrieves a list of section groups from the specified notebook within a Microsoft 365 group. Use this action to retrieve a page of section groups in a group-owned OneNote notebook to understand its structure or find a specific section group.

Compatibility alias for listing a page of OneNote pages from a specific section within a notebook in a Microsoft 365 group. Prefer the canonical ListOnenoteGroupSectionsPages4 action for new calls. Use this action when you need to retrieve a page of pages from a known section in a group notebook. This action accesses pages directly through the section path without going through section groups.

List OneNote notebooks owned by a Microsoft 365 group or Teams team. Use this with a group or team ID, including IDs returned by List joined teams.

List Microsoft Teams that a user is a direct member of. Use this to get team IDs, which are also Microsoft 365 group IDs, before listing group-owned OneNote notebooks.

Retrieves a list of OneNote pages from a specific section for the current user. Use this action when you need to retrieve a page of pages from a specific section in the current user's OneNote notebook. This action supports pagination, filtering, sorting, and relationship expansion via OData query parameters. The default query returns up to 10 pages. Note: This action is read-only and does not modify any data.

Lists a paginated collection of OneNote pages from a Microsoft 365 group. Use this action to retrieve a page of OneNote pages within a Microsoft 365 group. Supports pagination via page_size. The default page size is 10 and maximum is 100. Results are ordered by lastModifiedDateTime descending by default.

Canonical action for listing a paginated collection of OneNote pages from a specific section in a Microsoft 365 group. Use this action when you need to retrieve a page of pages from a known section in a group notebook without specifying the notebook ID. This action supports pagination, filtering, sorting, and relationship expansion via OData query parameters. Note: This action is read-only and does not modify any data.

Retrieves a list of section groups from the specified notebook within a SharePoint site. Use this action to retrieve a page of section groups in a SharePoint site-owned OneNote notebook to understand its structure or to find a specific section group. The default sort order is name ascending. The default query expands parentNotebook and selects its id, displayName, and self properties.

List OneNote notebooks stored in a SharePoint site. Use this after resolving a SharePoint site ID from a site name or URL when the user asks for notebooks in a SharePoint site.

Lists a paginated collection of OneNote sections from a specified user notebook. Use this action when you need to retrieve a page of sections within a notebook that is owned by or accessible to a specific user. Supports OData query parameters for filtering, sorting, and pagination. Note: The user_id can be a GUID or user principal name (UPN). Use 'me' to reference the signed-in user. The default sort order is by display name ascending. This is a read-only operation.

Lists a paginated collection of OneNote notebooks accessible by a specific user. Use this action when you need to retrieve the available notebooks for a user, display notebook listings, or browse notebooks that are owned by or shared with a specific user. Supports OData query parameters for filtering, sorting, and pagination. Note: The user_id can be a GUID or a user principal name (UPN). Use 'me' to reference the signed-in user.

Resolve a SharePoint site URL or hostname and path to a Microsoft Graph site resource. Use this when the user provides a SharePoint URL and a site ID is needed for OneNote notebook discovery.

Search SharePoint sites available through Microsoft Graph. Use this to find a site ID from a site name or keyword before listing site-hosted OneNote notebooks. Microsoft Graph site search does not support $count; page only with returned @odata.nextLink URLs.

Updates the navigation property sections in me. Use when you need to modify properties of an existing OneNote section, such as renaming it, within the current user's notebooks. This action uses a PATCH request to update the section entity at the specified path. Use this action when you need to update a specific OneNote section owned by the authenticated user, such as changing its display name. This operation modifies the specified properties while preserving all other existing values. Note: Only the displayName property can be updated via this endpoint. Other properties like isDefault, createdDateTime, etc. are read-only. This PATCH operation is provider-undocumented; its behavior is live-observed.

Canonical action for updating a OneNote section in a SharePoint site. Use this action when you need to modify properties of an existing section, such as renaming it. This action uses a PATCH request to update the section entity at the specified path within the site's notebook hierarchy. Note: Only the displayName property of a section can be updated via this endpoint. Other properties like createdDateTime, isDefault, etc. are read-only. This PATCH operation is provider-undocumented; its behavior is live-observed.

Compatibility alias for updating a OneNote section in a SharePoint site. Prefer UpdateSiteNotebooksSections for new site calls. Legacy notebook and section-group context does not affect the Graph route. Use this action when you need to modify properties of an existing OneNote section, such as updating its display name. This action uses a PATCH request to update the section entity at the specified path within the SharePoint site's notebook hierarchy. Note: Only the displayName property can be updated via this endpoint. Other properties are read-only. This PATCH operation is provider-undocumented; its behavior is live-observed.

Updates a OneNote section within a user's notebook. Use this action when you need to modify properties of an existing OneNote section, such as renaming it, for a specific user identified by their Microsoft Graph user ID. This action uses a PATCH request to update the section entity at the specified path within the user's notebook hierarchy. Note: Only the displayName property can be updated via this endpoint. Other properties like isDefault, createdDateTime, etc. are read-only. This PATCH operation is provider-undocumented; its behavior is live-observed.

Validates OneNote API credentials by attempting to access the user's notebooks. Use this action when you need to verify that the provided authentication token has valid permissions to access Microsoft OneNote. This action makes a lightweight API call to confirm the credentials work before performing other operations.

Copies a OneNote section to a specific notebook for a specified user. Use this action when you need to duplicate an existing OneNote section into a different notebook under a specific user's account. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. The copy is additive and does not remove the source section. Poll the returned Operation-Location value to determine the final outcome.

Copy a site-hosted OneNote section to a notebook natively.

Copies a OneNote section from a Microsoft 365 group's notebook into another section group. Use this action when you need to duplicate an existing OneNote section that lives in a Microsoft 365 group's notebook into a different section group. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. The copy is additive and does not remove the source section. Poll the returned Operation-Location value to determine the final outcome.

Copies a OneNote section to a specific section group for a specified user. Use this action when you need to duplicate an existing OneNote section into a different section group under a specific user's account. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. The copy is additive and does not remove the source section. Poll the returned Operation-Location value to determine the final outcome.

Copy a site-hosted OneNote page to a section natively.

Start an asynchronous copy of a user OneNote notebook.

Copy a OneNote page from a user's notebook to a specified section. Use this action when you need to duplicate a OneNote page into a different section within a user's Microsoft 365 account. This is an asynchronous operation that returns a 202 Accepted response with an Operation-Location header. Poll that endpoint to determine when the copy completes and get the result of the operation. The page is identified by its full path through the notebook's hierarchy.

Gets the provider-reported count of OneNote sections directly within a user's section group. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. This is a read-only operation.

Gets the provider-reported count of sections directly within a SharePoint site's OneNote section group. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. Microsoft Graph requires the `ConsistencyLevel: eventual` header when using the `$count=true` query parameter on OneNote endpoints.

Create a section group inside another group OneNote section group.

Creates a new OneNote notebook within a Microsoft 365 group. Use this action when you need to create a new notebook for storing notes within a specific Microsoft 365 group. The notebook will be owned by the specified group and accessible to all members of that group with appropriate permissions. Required permissions: Notes.Create (least privileged), Notes.ReadWrite, or Notes.ReadWrite.All for the group.

Creates a new OneNote section within a specified section group of a Microsoft 365 group. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy within a group. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Repeating the call with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Creates a new OneNote notebook for the signed-in user. Use this action when you need to create a new personal notebook to organize notes. The notebook will be created in the user's default OneDrive for Business location. Notebook names must be unique, cannot exceed 128 characters, and cannot contain ? * / : < > | ' or ". Ampersands are allowed. Returns the full created notebook object including the server-assigned ID and URLs for accessing sections.

Creates a new OneNote section within a specified section group of a notebook for the signed-in user. Use this action when you need to add a new section to organize OneNote pages within a user's section group hierarchy. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Repeating the call with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Creates a new section group within a OneNote notebook that belongs to a Microsoft 365 group. Use this action when you need to organize sections inside a group notebook by creating a new top-level section group to hold related sections together. The displayName must be 50 characters or fewer and cannot contain the characters ? * / : < > | & # ' % ~. Section group names must be unique within the same hierarchy level in the notebook.

Create a section group inside another site OneNote section group.

Create a OneNote notebook in a SharePoint site.

Creates a new OneNote section within a specified notebook in a SharePoint site. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a SharePoint site. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. This action is available in the following national cloud deployments: Global service only. Required permissions: Notes.Create (delegated/personal account), Notes.ReadWrite.All (application).

Create a section group inside another user OneNote section group.

Creates a new OneNote section within a specified notebook for a specific user. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a specific user. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Returns the full created section object including the server-assigned ID.

Creates a new OneNote section within a specified section group for a specific user. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy for a specific user's notebook. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Repeating the call with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Creates a new OneNote page in a specific section of a user's notebook. Use this action when you need to create a new page directly in a section within a user's OneNote notebook. The page content must be provided as valid HTML with proper structure (html, head, and body tags). Calling this action multiple times creates separate pages.

Retrieves the binary content of a specific OneNote resource using its ID. Use this action when you need to fetch the raw binary content of an image, file attachment, or other embedded resource from a OneNote page in the signed-in user's notebooks. The resource is identified by its unique resource_id, which can be obtained from page content URLs. Note: Binary content is returned as-is; images and files may need additional processing (e.g., base64 decoding or writing to a file) depending on your use case.

Retrieves the HTML content of a specific OneNote page from a section for the signed-in user. Use this action when you need to fetch the full HTML content of a OneNote page within a specific section. This endpoint provides access to page content for processing, rendering, or exporting page data. The returned HTML includes text, images, and other embedded content references. This action is read-only and does not modify any data.

Retrieves the status of a long-running OneNote operation for a group. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or is still in progress.

Retrieves the status of a long-running OneNote operation for a SharePoint site. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or is still in progress for a site.

Gets the HTML content of a specific OneNote page for a user. Use this action when you need to retrieve the actual HTML content of a specific OneNote page for reading, processing, or displaying page content. The action supports the includeIDs query parameter to include element IDs in the HTML, which is useful when preparing content for page updates via the PATCH endpoint.

Retrieves a specific OneNote page from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote page by its page identifier within a SharePoint site. This action supports optional OData query parameters to select specific properties or expand related entities like parentSection and parentNotebook. Note: This action is read-only and does not modify any data. It is the canonical action for the site page metadata route.

Retrieves a text preview of a specific OneNote page from a SharePoint site or the signed-in user's OneNote. Use this action when you need to quickly get the content preview of a OneNote page from a site-hosted notebook without fetching the full page content. The preview returns a text snippet of the page's content. This action is read-only and does not modify any data.

Poll the status of a user's asynchronous OneNote operation.

List section groups at the root of a Microsoft 365 group's OneNote hierarchy.

List sections at the root of a Microsoft 365 group's OneNote hierarchy.

Lists a paginated collection of OneNote sections from a section group within a Microsoft 365 group's OneNote. Use this action when you need to retrieve the sections contained within a section group in a group-owned OneNote notebook. Supports pagination and filtering via OData query parameters. This is a read-only operation that retrieves existing sections without modifying any data.

Lists a paginated collection of nested section groups from a specified parent section group within a Microsoft 365 group's OneNote notebook. Use this action when you need to retrieve the nested section groups within a section group in a group context to navigate the OneNote notebook hierarchy. This action supports OData query parameters for filtering, sorting, pagination, and expanding related entities.

Retrieves the HTML content of a specific OneNote page within a SharePoint site. Use this action when you need to fetch the full HTML content of a OneNote page from a SharePoint site for processing, rendering, or exporting page data. This endpoint provides direct access to page content without requiring notebook or section context. Returns the raw HTML content of the page, including text, images, and other embedded content references. Note: This action is read-only and does not modify any data.

List section groups at the root of a SharePoint site's OneNote hierarchy.

Retrieves a list of OneNote sections from a SharePoint site. Use this action to retrieve a page of OneNote sections within a SharePoint site's OneNote notebook to understand its structure or to find a specific section. This is a read-only operation that retrieves existing sections without modifying any data. Supports OData query parameters for filtering, sorting, pagination, and property expansion. The default sort order is name ascending. The default query expands parentNotebook and selects its id, displayName, and self properties.

List OneNote pages owned by a user, defaulting to the signed-in user.

List root OneNote section groups for a user, defaulting to the signed-in user.

List root OneNote sections for a user, defaulting to the signed-in user.

Update the content of a OneNote page for the signed-in user. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting siblings, replacing elements, and prepending content. Use this action when you need to update or modify the content of an existing OneNote page owned by the signed-in user, such as adding new paragraphs, inserting images, modifying lists, or replacing existing elements. Repeating append, prepend, or insert commands can add duplicate content.

Update the content of a OneNote page within a Microsoft 365 group using HTML patch commands. Use this action when you need to modify the content of an existing OneNote page, such as replacing text, inserting new content, or appending elements. The action supports multiple patch commands in a single request. The API returns 204 No Content on success, meaning no JSON response body is returned.

Update the content of a OneNote page within a SharePoint site. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting siblings, replacing elements, and prepending content. Use this action when you need to update or modify the content of an existing OneNote page within a SharePoint site, such as adding new paragraphs, inserting images, modifying lists, or replacing existing elements. Repeating append, prepend, or insert commands can add duplicate content.