Microsoft OneNote connector

What your chats can do

88 tools from Microsoft OneNote.

Copy notebook in groupCopies a OneNote notebook to the Notebooks folder in the destination Documents library. The notebook is copied asynchronously. This action initiates the copy operation and returns a 202 Accepted response with an Operation-Location header. Use the OnenoteOperationGet action to poll the Operation-Location endpoint to check the status of the copy operation until it completes. Use this action when you need to duplicate a notebook within a Microsoft 365 group, or copy it to a different group's documents library. The copied notebook's folder is created in the destination Documents library if it doesn't exist.
Copy notebook in siteCopies a OneNote notebook within a SharePoint site. Use this action when you need to duplicate a notebook within a SharePoint site. This is an asynchronous operation. Poll the returned operation URL to check whether the copy has completed.
Copy section to notebook (site context)Copy a site-hosted OneNote section to a notebook in the same SharePoint site. The copy is asynchronous; poll the returned operation URL for its status.
Copy section to notebook (user)Copies a user's OneNote section to a specified notebook. The operation is asynchronous and returns an operation location to poll for the final outcome; the copy does not remove the source section.
Copy group section to section groupCopies 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.
Copy section to section group (user)Copies a user's OneNote section to a specified section group. The operation is asynchronous and returns an operation location to poll for the final outcome; the copy does not remove the source section.
Copy site page to sectionCopy a site-hosted OneNote page to a section natively.
Copy user notebookStart an asynchronous copy of a user OneNote notebook.
Copy user page to sectionStart an asynchronous copy of a user's OneNote page to a specified section, optionally in a Microsoft 365 group. The returned operation location can be polled to determine the outcome.
Count user section group sectionsGets 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.
Count site section group sectionsGets 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 group nested section groupCreate a section group inside another group OneNote section group.
Create group notebookCreates 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.
Create group OneNote pageCreates a new OneNote page in the default section of the default notebook for a Microsoft 365 group. Use this action when you need to programmatically create a new page in a group's OneNote notebook. The page content must be provided as HTML. The page will be created in the default section of the default notebook unless a specific section name is provided via the sectionName query parameter.
Create section in section groupCreates 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.
Create user notebookCreates 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.
Create section in user's section groupCreates 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.
Create OneNote page in sectionCreates a OneNote page in a specified section for the signed-in user from an HTML content fragment, with an optional title and creation timestamp. Images and attachments can be referenced by external URLs or supplied as named binary resources.
Create section group in group notebookCreates 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 site nested section groupCreate a section group inside another site OneNote section group.
Create site notebookCreate a OneNote notebook in a SharePoint site.
Create section in site notebookCreate a OneNote section in a specified notebook in a SharePoint site or, when no site is supplied, in the signed-in user's OneNote. The section name must be unique at the same hierarchy level, be no longer than 50 characters, and exclude ?*/:<>|&#'%~.
Create site section pageCreate a OneNote page from HTML in a SharePoint site's section.
Create user nested section groupCreate a section group inside another user OneNote section group.
Create section in user notebookCreates a OneNote section in a specified user's notebook and returns available created-section details. The section name must be unique within the same hierarchy level, no longer than 50 characters, and cannot contain ?*/:<>|&#'%~.
Create user OneNote pageCreates a new OneNote page in the default section of the default notebook for a specific user. Use this action when you need to programmatically create a new page in a user's OneNote notebook. The page content must be provided as HTML. The page will be created in the default section of the default notebook unless a specific section name is provided via the sectionName query parameter.
Create section in user section groupCreates 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.
Create user section pageCreates a OneNote page in a specified user's section using HTML content, with optional named binary resources. When a title or creation time is supplied, the action wraps the content in an HTML document; otherwise, provide a complete HTML document.
Delete group section pageDeletes a OneNote page within a Microsoft 365 group's OneNote workspace. Canonical action for this group page deletion route. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply.
Delete OneNote page from sectionDelete a OneNote page by page ID within a Microsoft 365 group. Legacy notebook and section IDs are ignored; OneNote retention policies may apply.
Delete OneNote page from siteDeletes a OneNote page from a SharePoint site. Use this action to delete a OneNote page from a SharePoint site's OneNote workspace. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply.
Delete user OneNote page from sectionDeletes a OneNote page by page ID for a specified user or the current user; OneNote retention policies may still apply. Notebook, section group, and section IDs are ignored and do not constrain the deletion.
Delete OneNote page for userDeletes a OneNote page from a user's OneNote workspace. Canonical action for this user page deletion route. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply. Use this action when you need to remove an unwanted OneNote page from a user's notebook that has been shared with the current user.
Get group OneNote page contentRetrieves the raw HTML content of a OneNote page owned by a group.
Get a OneNote section from a groupRetrieves a specific OneNote section from a Microsoft 365 group. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the group ID and section ID. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.
Get OneNote resource content by IDRetrieves the binary content of a OneNote resource by ID from the signed-in user's notebooks. The content is returned as a base64-encoded string, along with the content type and length when available.
Get OneNote page content from sectionRetrieves 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.
Get notebook from web URLRetrieves a OneNote notebook by using its web URL path. Use this action when you have the SharePoint or OneDrive URL of a notebook and need to retrieve its properties and metadata. The webUrl parameter accepts both standard HTTPS URLs and OneNote protocol URLs with the 'onenote:' prefix. This API is available in the following national cloud deployments: Global service only. Required permissions: Notes.Create (delegated) or Notes.Read.All (application).
Get notebook section groupRetrieves 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.
Get group OneNote operation statusRetrieves 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.
Get a OneNote page from a groupRetrieves 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.
Get site OneNote operation statusRetrieves 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.
Get OneNote page content for userGets 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.
Get a OneNote pageRetrieves 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.
Get recent notebooksRetrieves 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.
Get a OneNote section by IDRetrieves 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.
Get OneNote page from siteRetrieves 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.
Get site notebook page previewRetrieves 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.
Get a OneNote section from a siteRetrieves 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.
Get OneNote page from site (compatibility alias)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.
Get user notebookRetrieves 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.
Get user OneNote operationPoll the status of a user's asynchronous OneNote operation.
Get a OneNote page from userRetrieves metadata for a specific OneNote page by user and page ID, with optional property selection, parent relationship expansion, and page level information.
Get parent section group from user sectionRetrieves the parent section group of a OneNote section in a user's notebook. If the response has no parent section group, the tool returns an empty parent object.
List group notebooksList 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 notebook section groupsRetrieves 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.
List pages from a group notebook sectionCompatibility 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 group notebook sectionsList one result page of sections directly contained in a specified Microsoft 365 group OneNote notebook; while has_more is true, pass next_cursor back as cursor to continue.
List group root section groupsList section groups at the root of a Microsoft 365 group's OneNote hierarchy.
List group root sectionsList sections at the root of a Microsoft 365 group's OneNote hierarchy.
List section group sectionsLists 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.
List joined teamsList 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.
List pages in sectionRetrieves 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.
List group OneNote pagesLists 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.
List group section group section groupsLists 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.
List pages from a group sectionCanonical 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.
List site notebooksList 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.
List site notebook section groupsRetrieves 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.
Get OneNote page content from SharePoint siteRetrieves 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 site root section groupsList section groups at the root of a SharePoint site's OneNote hierarchy.
List site section pagesList one result page of OneNote pages in a known SharePoint site section; pass next_cursor back as cursor to continue.
List site sectionsList a page of OneNote sections across a SharePoint site. Supports OData filtering, sorting, pagination, and property expansion.
List user notebooksLists 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.
List user notebook sectionsLists 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.
List user pagesList OneNote pages owned by a user, defaulting to the signed-in user.
List user root section groupsList root OneNote section groups for a user, defaulting to the signed-in user.
List user section group childrenReturn one independent result page each of direct sections and nested section groups beneath a personal OneNote section group. When a collection's has_more field is true, increase its independent skip offset by the number of items returned to continue.
List user sectionsList root OneNote sections for a user, defaulting to the signed-in user.
Resolve SharePoint site by URLResolve 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 sitesSearch 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.
Update my OneNote page contentUpdate 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 my OneNote sectionUpdates 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.
Update OneNote page contentUpdate the content of a OneNote page in a Microsoft 365 group using one or more HTML patch commands. A successful 204 response is returned as a success status and message.
Update section in site notebookCanonical 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.
Update site OneNote page contentUpdate 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.
Update site section group sectionCompatibility 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.
Update section in user notebookUpdates 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.
Validate OneNote credentialsValidates 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.

Microsoft OneNote

Connect Microsoft OneNote

What your chats can do