
Microsoft OneNote
Digital note-taking and organization platform
| API | Protocol | Base URL | Docs | Reference | OpenAPI | SDKs |
|---|---|---|---|---|---|---|
| Main | rest | https://graph.microsoft.com/v1.0 | link | — | — | — |
Actions (58)
Notebooks · 15
- Create notebookPOST https://www.onenote.com/api/v1.0/me/notes/notebooks
Create a new notebook in the current user’s OneNote location.
documented - Get notebookGET https://www.onenote.com/api/v1.0/notebooks/{notebook_id}
Get metadata for a specific notebook by ID.
documented - Get notebookGET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}
Get metadata for a notebook.
documented - Get recent notebooksGET https://www.onenote.com/api/v1.0/notebooks/getrecentnotebooks?includePersonalNotebooks=true
Return a list of notebooks the user has recently accessed.
documented - Get recent notebooks (extended)GET https://www.onenote.com/api/v1.0/me/notes/notebooks/getrecentnotebooks?includePersonalNotebooks=true
Return a list of notebooks the current user has recently accessed (with personal notebooks option).
documented - List notebooksGET https://www.onenote.com/api/v1.0/me/notes/notebooks
Retrieve notebooks owned by the current user in OneNote (OneDrive for Business).
documented - List notebooks (Graph)GET https://graph.microsoft.com/v1.0/me/onenote/notebooks
Retrieve notebooks accessible to the signed-in user.
documented - List notebooks (group)GET https://www.onenote.com/api/v1.0/myOrganization/groups/{group_id}/notes
List notebooks in a unified group (Office 365 Groups).
documented - List notebooks (user)GET https://graph.microsoft.com/v1.0/users/{user-id}/onenote/notebooks
List notebooks for a specified user.
documented - List notebooks (user)GET https://www.onenote.com/api/v1.0/users/{user_id}/notes/notebooks
List notebooks for a specific user by user ID.
documented - List section groupsGET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/sectionGroups
List section groups in a notebook.
documented - List section groupsGET https://www.onenote.com/api/v1.0/me/notes/notebooks/{notebook_id}/sectionGroups
List section groups within a notebook.
documented - List sectionsGET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/sections
List sections in a notebook.
documented - List sectionsGET https://www.onenote.com/api/v1.0/me/notes/notebooks/{notebook_id}/sections
List sections contained in a given notebook.
documented - List sections (notebook)GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/sections
List sections within a specific notebook.
documented
Class Notebooks · 14
- Copy sections to content library (Graph)GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/copySectionsToContentLibrary
Copy sections from a class notebook to the content library.
documented - Create class notebookPOST https://www.onenote.com/api/v1.0/me/notes/classNotebooks
Create a class notebook for a teacher in OneNote Class Notebook (Office 365 only).
documented - Create class notebook (Graph)POST https://graph.microsoft.com/v1.0/me/onenote/classNotebooks
Create a class notebook in OneNote Class Notebook via Graph.
documented - Create class notebook (user)POST https://www.onenote.com/api/v1.0/users/{teacher_id}/notes/classNotebooks
Create a class notebook for a specific teacher user.
documented - Delete class notebook (Graph)DELETE https://graph.microsoft.com/v1.0/me/onenote/classNotebooks/{notebook-id}
Delete a class notebook.
documented - Get class notebookGET https://www.onenote.com/api/v1.0/classNotebooks/{notebook-id}
Fetch a single class notebook by ID.
documented - Get class notebook (Graph)GET https://graph.microsoft.com/v1.0/me/onenote/classNotebooks/{notebook-id}
Get a specific class notebook.
documented - List class notebooksGET https://www.onenote.com/api/v1.0/me/notes/classNotebooks
List class notebooks for the current user.
documented - List class notebooks (Graph)GET https://graph.microsoft.com/v1.0/me/onenote/classNotebooks
List class notebooks for the current user.
documented - List class notebooks (SharePoint site)GET https://www.onenote.com/api/v1.0/myOrganization/sites/{siteId}/notes/classNotebooks
List class notebooks stored in a SharePoint site (via site collection).
documented - List students (Graph)GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/students
List students assigned to a class notebook.
documented - List teachers (Graph)GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/teachers
List teachers assigned to a class notebook.
documented - Update class notebookPATCH https://www.onenote.com/api/v1.0/classNotebooks/{notebook-id}
Update class notebook properties (e.g., hasTeacherOnlySectionGroup).
documented - Update class notebook (Graph)PATCH https://graph.microsoft.com/v1.0/me/onenote/classNotebooks/{notebook-id}
Update class notebook properties (e.g., hasTeacherOnlySectionGroup).
documented
Pages · 12
- Create page in default notebookPOST https://graph.microsoft.com/v1.0/me/onenote/pages
Create a page in the default notebook/section when section is not specified.
documented - Create page in named section (default notebook)POST https://graph.microsoft.com/v1.0/me/onenote/pages?sectionName={section-name}
Create a page in the default notebook and a named section via the sectionName parameter.
documented - Get pageGET https://graph.microsoft.com/v1.0/me/onenote/pages/{page-id}
Get a specific OneNote page.
documented - Get page HTML contentGET https://graph.microsoft.com/v1.0/me/onenote/pages/{page-id}/content
Get the HTML content of a page.
documented - Get page HTML content with IDsGET https://graph.microsoft.com/v1.0/me/onenote/pages/{page-id}/content?includeIDs=true
Get HTML content including generated IDs for updating content.
documented - Get page metadataGET https://graph.microsoft.com/v1.0/me/onenote/notes/pages/{page-id}
Get metadata for a specific page.
documented - Get page previewGET https://graph.microsoft.com/v1.0/me/onenote/pages/{page-id}/preview
Get a text/image preview for a page.
documented - Get page resource valueGET https://graph.microsoft.com/v1.0/me/onenote/contents/pages/{page-id}/$value
Get binary content for a page resource.
documented - List page metadataGET https://graph.microsoft.com/v1.0/me/onenote/notes/pages
Get page metadata across notebooks (paged).
documented - List pagesGET https://graph.microsoft.com/v1.0/me/onenote/pages
List OneNote pages accessible to the user.
documented - List pages (all)GET https://www.onenote.com/api/v1.0/me/notes/pages
List pages accessible to the current user across notebooks.
documented - Update page contentPATCH https://graph.microsoft.com/v1.0/me/onenote/pages/{page-id}/content
Update the content of a OneNote page using HTML diffs.
documented
Copy operations · 8
- Copy notebookPOST https://www.onenote.com/api/v1.0/notebooks/{notebook_id}/copyNotebook
Copy a notebook to a destination location (requires destination IDs).
documented - Copy notebook (Graph)POST https://graph.microsoft.com/v1.0/me/onenote/notebooks/{notebook-id}/copyNotebook
Copy a notebook to another location.
documented - Copy page to sectionPOST https://www.onenote.com/api/v1.0/me/notes/pages/{page_id}/copyToSection
Copy a page into a different section.
documented - Copy page to section (Graph)POST https://graph.microsoft.com/v1.0/me/onenote/pages/{page-id}/copyToSection
Copy a page to a different section.
documented - Copy section to notebookPOST https://www.onenote.com/api/v1.0/me/notes/sections/{section_id}/copyToNotebook
Copy a section to a destination notebook.
documented - Copy section to notebook (Graph)POST https://graph.microsoft.com/v1.0/me/onenote/sections/{section-id}/copyToNotebook
Copy a section to a destination notebook.
documented - Copy section to section groupPOST https://www.onenote.com/api/v1.0/me/notes/sections/{section_id}/copyToSectionGroup
Copy a section to a section group.
documented - Copy section to section group (Graph)POST https://graph.microsoft.com/v1.0/me/onenote/sections/{section-id}/copyToSectionGroup
Copy a section to a destination section group.
documented
Sections · 5
- Create page in sectionPOST https://graph.microsoft.com/v1.0/me/onenote/sections/{section-id}/pages
Create a new page in a given section by posting HTML content.
documented - Get sectionGET https://www.onenote.com/api/v1.0/me/notes/sections/{section_id}
Get metadata for a specific section.
documented - Get sectionGET https://graph.microsoft.com/v1.0/me/onenote/sections/{section-id}
Get a specific OneNote section.
documented - List pages in sectionGET https://graph.microsoft.com/v1.0/me/onenote/sections/{section-id}/pages
List pages in a specific section.
documented - List pages in sectionGET https://www.onenote.com/api/v1.0/me/notes/sections/{section_id}/pages
List all pages in a specific section.
documented
FromUrl / SharePoint · 2
- FromUrl (site collection)GET https://www.onenote.com/api/v1.0/myOrganization/siteCollections/FromUrl(url='{full-path-to-SharePoint-site}')
Resolve a SharePoint site URL to siteCollection/site IDs for OneNote usage.
documented - FromUrl to site collectionGET https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionId}/sites/{siteId}/notes/FromUrl(url='{full-path-to-SharePoint-site}')
Resolve a SharePoint site URL to siteCollection/site IDs for OneNote usage.
documented