ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

Notes.Read.All

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read All Resources

Allows the app to read all the OneNote notebooks in your organization, without a signed-in user.

In short

Notes.Read.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the Notes category. Allows the app to read all the OneNote notebooks in your organization, without a signed-in user. It grants read-only access to resources. Application permissions always require admin consent.

Permission data: September 15, 2026 at 3:10 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read all OneNote notebooks

Allows the app to read all the OneNote notebooks in your organization, without a signed-in user.

Permission ID: 3aeca27b-ee3a-4c2b-8ded-80376e2134a4
Delegated Permission User consent allowed

Read all OneNote notebooks that user can access

Allows the app to read OneNote notebooks that the signed-in user has access to in the organization.

User sees: Allows the app to read all the OneNote notebooks that you have access to.
Permission ID: dfabfca6-ee36-4db2-8208-7a28381419b3

Properties

Microsoft Graph v1.0 mapped-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property Type Description
id string The unique identifier for an entity. Read-only.
notebooks notebook collection The collection of OneNote notebooks that are owned by the user or group. Read-only. Nullable.
operations onenoteOperation collection The status of OneNote operations. Getting an operations collection isn't supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. Read-only. Nullable.
pages onenotePage collection The pages in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
resources onenoteResource collection The image and other file resources in OneNote pages. Getting a resources collection isn't supported, but you can get the binary content of a specific resource. Read-only. Nullable.
sectionGroups sectionGroup collection The section groups in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
sections onenoteSection collection The sections in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.

JSON Representation

Microsoft Graph v1.0 mapped-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation 
{
  "notebooks": [
    {
      "@odata.type": "microsoft.graph.notebook"
    }
  ],
  "operations": [
    {
      "@odata.type": "microsoft.graph.onenoteOperation"
    }
  ],
  "pages": [
    {
      "@odata.type": "microsoft.graph.onenotePage"
    }
  ],
  "resources": [
    {
      "@odata.type": "microsoft.graph.onenoteResource"
    }
  ],
  "sectionGroups": [
    {
      "@odata.type": "microsoft.graph.sectionGroup"
    }
  ],
  "sections": [
    {
      "@odata.type": "microsoft.graph.onenoteSection"
    }
  ]
}

Relationships

Microsoft Graph v1.0 mapped-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship Type Description
notebooks notebook collection The collection of OneNote notebooks that are owned by the user or group. Read-only. Nullable.
operations onenoteOperation collection The status of OneNote operations. Getting an operations collection isn't supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. Read-only. Nullable.
pages onenotePage collection The pages in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
resources onenoteResource collection The image and other file resources in OneNote pages. Getting a resources collection isn't supported, but you can get the binary content of a specific resource. Read-only. Nullable.
sectionGroups sectionGroup collection The section groups in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
sections onenoteSection collection The sections in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.

Graph Methods

Delegated access App-only access
Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /groups/{id}/onenote/notebooks
GET /groups/{id}/onenote/notebooks/{id}
GET /groups/{id}/onenote/notebooks/{id}/sectionGroups
GET /groups/{id}/onenote/notebooks/{id}/sections
GET /groups/{id}/onenote/operations/{id}
GET /groups/{id}/onenote/pages
GET /groups/{id}/onenote/pages/{id}
GET /groups/{id}/onenote/resources/{id}/content
GET /groups/{id}/onenote/sectionGroups
GET /groups/{id}/onenote/sectionGroups/{id}
GET /groups/{id}/onenote/sectionGroups/{id}/sectionGroups
GET /groups/{id}/onenote/sectionGroups/{id}/sections
GET /groups/{id}/onenote/sections
GET /groups/{id}/onenote/sections/{id}
GET /groups/{id}/onenote/sections/{id}/pages
GET /me/onenote/notebooks
GET /me/onenote/notebooks/{id}
GET /me/onenote/notebooks/{id}/sectionGroups
GET /me/onenote/notebooks/{id}/sections
GET /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
GET /me/onenote/operations/{id}
GET /me/onenote/pages
GET /me/onenote/pages/{id}
GET /me/onenote/resources/{id}/content
GET /me/onenote/sectionGroups
GET /me/onenote/sectionGroups/{id}
GET /me/onenote/sectionGroups/{id}/sectionGroups
GET /me/onenote/sectionGroups/{id}/sections
GET /me/onenote/sections
GET /me/onenote/sections/{id}
GET /me/onenote/sections/{id}/pages
GET /sites/{id}/onenote/notebooks
GET /sites/{id}/onenote/notebooks/{id}
GET /sites/{id}/onenote/notebooks/{id}/sectionGroups
GET /sites/{id}/onenote/notebooks/{id}/sections
GET /sites/{id}/onenote/operations/{id}
GET /sites/{id}/onenote/pages
GET /sites/{id}/onenote/pages/{id}
GET /sites/{id}/onenote/resources/{id}/content
GET /sites/{id}/onenote/sectionGroups
GET /sites/{id}/onenote/sectionGroups/{id}
GET /sites/{id}/onenote/sectionGroups/{id}/sectionGroups
GET /sites/{id}/onenote/sectionGroups/{id}/sections
GET /sites/{id}/onenote/sections
GET /sites/{id}/onenote/sections/{id}
GET /sites/{id}/onenote/sections/{id}/pages
GET /users/{id | userPrincipalName}/onenote/notebooks
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}/sectionGroups
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}/sections
GET /users/{id | userPrincipalName}/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
GET /users/{id | userPrincipalName}/onenote/operations/{id}
GET /users/{id | userPrincipalName}/onenote/pages
GET /users/{id | userPrincipalName}/onenote/pages/{id}
GET /users/{id | userPrincipalName}/onenote/resources/{id}/content
GET /users/{id | userPrincipalName}/onenote/sectionGroups
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}/sectionGroups
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}/sections
GET /users/{id | userPrincipalName}/onenote/sections
GET /users/{id | userPrincipalName}/onenote/sections/{id}
GET /users/{id | userPrincipalName}/onenote/sections/{id}/pages
POST /groups/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /me/onenote/notebooks/GetNotebookFromWebUrl
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /users/{id | userPrincipalName}/onenote/notebooks/GetNotebookFromWebUrl
Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET /groups/{id}/onenote/notebooks
GET /groups/{id}/onenote/notebooks/{id}
GET /groups/{id}/onenote/notebooks/{id}/sectionGroups
GET /groups/{id}/onenote/notebooks/{id}/sections
GET /groups/{id}/onenote/operations/{id}
GET /groups/{id}/onenote/pages
GET /groups/{id}/onenote/pages/{id}
GET /groups/{id}/onenote/resources/{id}/content
GET /groups/{id}/onenote/sectionGroups
GET /groups/{id}/onenote/sectionGroups/{id}
GET /groups/{id}/onenote/sectionGroups/{id}/sectionGroups
GET /groups/{id}/onenote/sectionGroups/{id}/sections
GET /groups/{id}/onenote/sections
GET /groups/{id}/onenote/sections/{id}
GET /groups/{id}/onenote/sections/{id}/pages
GET /me/onenote/notebooks
GET /me/onenote/notebooks/{id}
GET /me/onenote/notebooks/{id}/sectionGroups
GET /me/onenote/notebooks/{id}/sections
GET /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
GET /me/onenote/operations/{id}
GET /me/onenote/pages
GET /me/onenote/pages/{id}
GET /me/onenote/resources/{id}/content
GET /me/onenote/sectionGroups
GET /me/onenote/sectionGroups/{id}
GET /me/onenote/sectionGroups/{id}/sectionGroups
GET /me/onenote/sectionGroups/{id}/sections
GET /me/onenote/sections
GET /me/onenote/sections/{id}
GET /me/onenote/sections/{id}/pages
GET /sites/{id}/onenote/notebooks
GET /sites/{id}/onenote/notebooks/{id}
GET /sites/{id}/onenote/notebooks/{id}/sectionGroups
GET /sites/{id}/onenote/notebooks/{id}/sections
GET /sites/{id}/onenote/operations/{id}
GET /sites/{id}/onenote/pages
GET /sites/{id}/onenote/pages/{id}
GET /sites/{id}/onenote/resources/{id}/content
GET /sites/{id}/onenote/sectionGroups
GET /sites/{id}/onenote/sectionGroups/{id}
GET /sites/{id}/onenote/sectionGroups/{id}/sectionGroups
GET /sites/{id}/onenote/sectionGroups/{id}/sections
GET /sites/{id}/onenote/sections
GET /sites/{id}/onenote/sections/{id}
GET /sites/{id}/onenote/sections/{id}/pages
GET /users/{id | userPrincipalName}/onenote/notebooks
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}/sectionGroups
GET /users/{id | userPrincipalName}/onenote/notebooks/{id}/sections
GET /users/{id | userPrincipalName}/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
GET /users/{id | userPrincipalName}/onenote/operations/{id}
GET /users/{id | userPrincipalName}/onenote/pages
GET /users/{id | userPrincipalName}/onenote/pages/{id}
GET /users/{id | userPrincipalName}/onenote/resources/{id}/content
GET /users/{id | userPrincipalName}/onenote/sectionGroups
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}/sectionGroups
GET /users/{id | userPrincipalName}/onenote/sectionGroups/{id}/sections
GET /users/{id | userPrincipalName}/onenote/sections
GET /users/{id | userPrincipalName}/onenote/sections/{id}
GET /users/{id | userPrincipalName}/onenote/sections/{id}/pages
POST /groups/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /me/onenote/notebooks/GetNotebookFromWebUrl
POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
POST /users/{id | userPrincipalName}/onenote/notebooks/GetNotebookFromWebUrl
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgUserOnenoteNotebook /me/onenote/notebooks
List notebooks
Get-MgUserOnenoteNotebook /me/onenote/notebooks/{id}
Get notebook
Get-MgUserOnenoteNotebookFromWebUrl /me/onenote/notebooks/GetNotebookFromWebUrl
notebook: getNotebookFromWebUrl
Get-MgUserOnenoteNotebookRecentNotebook /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
notebook: getRecentNotebooks
Get-MgUserOnenoteNotebookSection /me/onenote/notebooks/{id}/sections
List sections
Get-MgUserOnenoteNotebookSectionGroup /me/onenote/notebooks/{id}/sectionGroups
List sectionGroups
Get-MgUserOnenoteOperation /me/onenote/operations/{id}
Get onenoteOperation
Get-MgUserOnenotePage /me/onenote/pages
List onenotePages
Get-MgUserOnenotePage /me/onenote/pages/{id}
Get page
Get-MgUserOnenoteResourceContent /me/onenote/resources/{id}/content
Get resource
Get-MgUserOnenoteSection /me/onenote/sections
List sections
Get-MgUserOnenoteSection /me/onenote/sections/{id}
Get section
Get-MgUserOnenoteSectionGroup /me/onenote/sectionGroups
List sectionGroups
Get-MgUserOnenoteSectionGroup /me/onenote/sectionGroups/{id}
Get sectionGroup
Get-MgUserOnenoteSectionGroupSection /me/onenote/sectionGroups/{id}/sections
List sections
Get-MgUserOnenoteSectionPage /me/onenote/sections/{id}/pages
List pages
Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
Get-MgBetaUserOnenoteNotebook /me/onenote/notebooks
List notebooks
Get-MgBetaUserOnenoteNotebook /me/onenote/notebooks/{id}
Get notebook
Get-MgBetaUserOnenoteNotebookFromWebUrl /me/onenote/notebooks/GetNotebookFromWebUrl
notebook: getNotebookFromWebUrl
Get-MgBetaUserOnenoteNotebookRecentNotebook /me/onenote/notebooks/getRecentNotebooks(includePersonalNotebooks={includePersonalNotebooks})
notebook: getRecentNotebooks
Get-MgBetaUserOnenoteNotebookSection /me/onenote/notebooks/{id}/sections
List sections
Get-MgBetaUserOnenoteNotebookSectionGroup /me/onenote/notebooks/{id}/sectionGroups
List sectionGroups
Get-MgBetaUserOnenoteOperation /me/onenote/operations/{id}
Get onenoteOperation
Get-MgBetaUserOnenoteResourceContent /me/onenote/resources/{id}/content
Get resource
Get-MgBetaUserOnenoteSection /me/onenote/sections
List sections
Get-MgBetaUserOnenoteSection /me/onenote/sections/{id}
Get section
Get-MgBetaUserOnenoteSectionGroup /me/onenote/sectionGroups
List sectionGroups
Get-MgBetaUserOnenoteSectionGroup /me/onenote/sectionGroups/{id}
Get sectionGroup
Get-MgBetaUserOnenoteSectionGroupSection /me/onenote/sectionGroups/{id}/sections
List sections

Code Examples

C# / .NET SDK
Get notebook
View official example on Microsoft Learn
// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Onenote.Notebooks["{notebook-id}"].GetAsync();
JavaScript
Get notebook
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

let notebook = await client.api('/me/onenote/notebooks/1-e13f257d-78c6-46cf-ae8c-13686517ac5f')
	.get();
PowerShell
Get notebook
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Notes
# A UPN can also be used as -UserId.
Get-MgUserOnenoteNotebook -UserId $userId -NotebookId $notebookId
Python
Get notebook
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.me.onenote.notebooks.by_notebook_id('notebook-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for Notes.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.

Frequently asked questions

What is the Notes.Read.All Microsoft Graph permission?

Notes.Read.All is available as both an application permission and a delegated permission in the Microsoft Graph API, grouped under the Notes category. Allows the app to read all the OneNote notebooks in your organization, without a signed-in user. It grants read-only access to resources. Application permissions always require admin consent. It is mapped to the Microsoft Graph onenote resource type. 132 documented Microsoft Graph REST methods require it. 29 Microsoft Graph PowerShell commands are documented for it.

Is Notes.Read.All an application or a delegated permission?

Notes.Read.All is available as both an application permission (app-only access, no signed-in user) and a delegated permission (access on behalf of a signed-in user).

Does Notes.Read.All require admin consent?

Application permissions always require admin consent.

What is the permission ID (GUID) for Notes.Read.All?

For Notes.Read.All, the application (app role) ID is 3aeca27b-ee3a-4c2b-8ded-80376e2134a4, and the delegated (OAuth2 scope) ID is dfabfca6-ee36-4db2-8208-7a28381419b3. These are the real Microsoft Graph identifiers and can be used directly in an app registration manifest.