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

Notes.Read

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the app to read OneNote notebooks on behalf of the signed-in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Delegated Permission User consent allowed

Read user OneNote notebooks

Allows the app to read OneNote notebooks on behalf of the signed-in user.

User sees: Allows the app to read OneNote notebooks on your behalf.
Permission ID: 371361e4-b9e2-4a3f-8315-2a301a3b0a3d

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 page
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.Pages["{onenotePage-id}"].GetAsync();
JavaScript
Get page
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

let onenotePage = await client.api('/me/onenote/pages/{id}')
	.get();
PowerShell
Get page
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Notes
# A UPN can also be used as -UserId.
Get-MgUserOnenotePage -UserId $userId -OnenotePageId $onenotePageId
Python
Get page
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.pages.by_onenote_page_id('onenotePage-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 Delegated permissions and search for Notes.Read

4

Grant Admin Consent

Users can consent to this permission during sign-in.