Skip to main content

OneNote connector

Back to the connector overview, authentication methods, and actions.
20 Nov 2026
new-feature description-fixAdded a sectionName option to Create User Page, so a page can be placed in a named section of the user’s default notebook rather than only the default section. Clarified when to use Create Page, which takes a specific section ID, against Create User Page, which targets the default notebook. The section and page copy actions now set out that they return an operation whose status begins as ‘not started’, meaning queued rather than finished, and that it must be polled with Get Operation Status until it reads ‘Completed’ — a destination name clash shows up there as a ‘Failed’ status carrying error 20117, not as an error on the original request. Page listing actions explain the 422 OneNote returns when a section cannot be synced and how to read pages one section at a time instead, and the page filter options now show the supported way to match a page by title. Section and section group actions explain how to confirm that a copy destination sits inside a notebook, which keeps copied sections readable and keeps account-wide page listing working.
onenote_copy_page_to_section, onenote_copy_section_to_notebook, onenote_copy_section_to_section_group, onenote_create_page, onenote_create_section, onenote_create_section_in_group, onenote_create_user_page, onenote_get_operation_status, onenote_get_section, onenote_get_section_group, onenote_list_notebook_section_groups, onenote_list_pages, onenote_list_section_group_nested_groups, onenote_list_section_group_sections, onenote_list_section_groups, onenote_list_section_pages, onenote_list_sections, onenote_list_user_pages, onenote_list_user_section_groups, onenote_list_user_sections
19 Nov 2026
auth guideMoved Tenant ID from Link Account to the Connector Profile and made it optional, so an end user linking an account no longer has to find their Microsoft Entra tenant ID. A single-tenant app registration belongs to one tenant, so the tenant ID now sits with the app. Leave it blank on a multi-tenant app and sign-in goes through the shared organizations endpoint instead. Accounts linked before this release keep the tenant ID already stored on them.
onenote_copy_notebook, onenote_copy_page_to_section, onenote_copy_section_to_notebook, onenote_copy_section_to_section_group, onenote_create_notebook, onenote_create_page, onenote_create_section, onenote_create_section_in_group, onenote_create_user_notebook, onenote_create_user_page, onenote_delete_page, onenote_get_notebook, onenote_get_operation_status, onenote_get_page, onenote_get_page_content, onenote_get_page_preview, onenote_get_recent_notebooks, onenote_get_resource, onenote_get_section, onenote_get_section_group, onenote_get_user, onenote_get_user_notebook, onenote_get_user_section, onenote_list_notebook_section_groups, onenote_list_notebook_sections, onenote_list_notebooks, onenote_list_pages, onenote_list_section_group_nested_groups, onenote_list_section_group_sections, onenote_list_section_groups, onenote_list_section_pages, onenote_list_sections, onenote_list_user_notebooks, onenote_list_user_pages, onenote_list_user_section_groups, onenote_list_user_sections, onenote_list_users
9 Nov 2026
guideUpdated the connector profile guides.
23 Sept 2026
data-sync new-featureAdded Data Sync support for notebooks, sections, section groups and directory users, all full refresh as no updated-since filter is configured. List Users gains an optional skiptoken input and returns a next value, so paging can follow Microsoft Graph’s skip token.
onenote_list_notebooks, onenote_list_section_groups, onenote_list_sections, onenote_list_users
13 Jul 2026
description-fixAdded Client Credentials auth, description fixes for list_pages/copy/list_users error handling, and documented cross-user access limitation on user-scoped actions.