Notes.ReadWrite

Allows the app to read, share, and modify OneNote notebooks on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the Notes.ReadWrite permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	615e26af-c38a-4150-ae3e-c3b0d4cb1d6a
DisplayText	-	Read and write user OneNote notebooks
Description	-	Allows the app to read, share, and modify OneNote notebooks on behalf of the signed-in user.
AdminConsentRequired	Yes	No

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	DELETE /groups/{id}/onenote/pages/{id}
	DELETE /me/onenote/pages/{id}
	DELETE /sites/{id}/onenote/pages/{id}
	DELETE /users/{id | userPrincipalName}/onenote/pages/{id}
	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/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/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/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
	PATCH /groups/{id}/onenote/pages/{id}/content
	PATCH /me/onenote/pages/{id}/content
	PATCH /sites/{id}/onenote/pages/{id}/content
	PATCH /users/{id | userPrincipalName}/onenote/pages/{id}/content
	POST /groups/{id}/onenote/notebooks
	POST /groups/{id}/onenote/notebooks/{id}/copyNotebook
	POST /groups/{id}/onenote/notebooks/{id}/sectionGroups
	POST /groups/{id}/onenote/notebooks/{id}/sections
	POST /groups/{id}/onenote/notebooks/GetNotebookFromWebUrl
	POST /groups/{id}/onenote/pages
	POST /groups/{id}/onenote/pages/{id}/copyToSection
	POST /groups/{id}/onenote/sectionGroups/{id}/sectionGroups
	POST /groups/{id}/onenote/sectionGroups/{id}/sections
	POST /groups/{id}/onenote/sections/{id}/copyToNotebook
	POST /groups/{id}/onenote/sections/{id}/copyToSectionGroup
	POST /groups/{id}/onenote/sections/{id}/pages
	POST /me/onenote/notebooks
	POST /me/onenote/notebooks/{id}/copyNotebook
	POST /me/onenote/notebooks/{id}/sectionGroups
	POST /me/onenote/notebooks/{id}/sections
	POST /me/onenote/notebooks/GetNotebookFromWebUrl
	POST /me/onenote/pages
	POST /me/onenote/pages/{id}/copyToSection
	POST /me/onenote/sectionGroups/{id}/sectionGroups
	POST /me/onenote/sectionGroups/{id}/sections
	POST /me/onenote/sections/{id}/copyToNotebook
	POST /me/onenote/sections/{id}/copyToSectionGroup
	POST /me/onenote/sections/{id}/pages
	POST /sites/{id}/onenote/notebooks
	POST /sites/{id}/onenote/notebooks/{id}/sectionGroups
	POST /sites/{id}/onenote/notebooks/{id}/sections
	POST /sites/{id}/onenote/notebooks/GetNotebookFromWebUrl
	POST /sites/{id}/onenote/pages
	POST /sites/{id}/onenote/sectionGroups/{id}/sectionGroups
	POST /sites/{id}/onenote/sectionGroups/{id}/sections
	POST /sites/{id}/onenote/sections/{id}/pages
	POST /users/{id | userPrincipalName}/onenote/notebooks
	POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/copyNotebook
	POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/sectionGroups
	POST /users/{id | userPrincipalName}/onenote/notebooks/{id}/sections
	POST /users/{id | userPrincipalName}/onenote/notebooks/GetNotebookFromWebUrl
	POST /users/{id | userPrincipalName}/onenote/pages
	POST /users/{id | userPrincipalName}/onenote/pages/{id}/copyToSection
	POST /users/{id | userPrincipalName}/onenote/sectionGroups/{id}/sectionGroups
	POST /users/{id | userPrincipalName}/onenote/sectionGroups/{id}/sections
	POST /users/{id | userPrincipalName}/onenote/sections/{id}/copyToNotebook
	POST /users/{id | userPrincipalName}/onenote/sections/{id}/copyToSectionGroup
	POST /users/{id | userPrincipalName}/onenote/sections/{id}/pages

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• notebook
• onenoteOperation
• onenotePage
• onenoteResource
• onenoteSection
• onenotePage
• patchContentCommand
• recentNotebook
• oneNoteResource
• onenoteSection
• sectionGroup

Graph reference: notebook

Property	Type	Description
createdBy	identitySet	Identity of the user, device, and application which created the item. Read-only.
createdDateTime	DateTimeOffset	The date and time when the notebook was created. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
displayName	String	The name of the notebook.
id	String	The unique identifier of the notebook. Read-only.
isDefault	Boolean	Indicates whether this is the user's default notebook. Read-only.
isShared	Boolean	Indicates whether the notebook is shared. If true, the contents of the notebook can be seen by people other than the owner. Read-only.
lastModifiedBy	identitySet	Identity of the user, device, and application which created the item. Read-only.
lastModifiedDateTime	DateTimeOffset	The date and time when the notebook was last modified. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
links	NotebookLinks	Links for opening the notebook. The oneNoteClientURL link opens the notebook in the OneNote native client if it's installed. The oneNoteWebURL link opens the notebook in OneNote on the web.
sectionGroupsUrl	String	The URL for the sectionGroups navigation property, which returns all the section groups in the notebook. Read-only.
sectionsUrl	String	The URL for the sections navigation property, which returns all the sections in the notebook. Read-only.
self	String	The endpoint where you can get details about the notebook. Read-only.
userRole	onenoteUserRole	Possible values are: Owner, Contributor, Reader, None. Owner represents owner-level access to the notebook. Contributor represents read/write access to the notebook. Reader represents read-only access to the notebook. Read-only.