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

Notes.Create

Export JSON
Export CSV
Copy URL
Print
Delegated Read User Scope

Allows the app to read the titles of OneNote notebooks and sections and to create new pages, notebooks, and sections 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

Create user OneNote notebooks

Allows the app to read the titles of OneNote notebooks and sections and to create new pages, notebooks, and sections on behalf of the signed-in user.

User sees: Allows the app to view the titles of your OneNote notebooks and sections and to create new pages, notebooks, and sections on your behalf.
Permission ID: 9d822255-d64d-4b7a-afdb-833b9a97ed02

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/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 /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/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 /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/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 /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/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}
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
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/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 /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/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 /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/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 /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/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}
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}/copyNotebook
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/pages/{id}/copyToSection
POST /sites/{id}/onenote/sectionGroups/{id}/sectionGroups
POST /sites/{id}/onenote/sectionGroups/{id}/sections
POST /sites/{id}/onenote/sections/{id}/copyToNotebook
POST /sites/{id}/onenote/sections/{id}/copyToSectionGroup
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
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-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
New-MgUserOnenoteNotebook /me/onenote/notebooks
Create notebook
New-MgUserOnenoteNotebookSection /me/onenote/notebooks/{id}/sections
Create section
New-MgUserOnenoteNotebookSectionGroup /me/onenote/notebooks/{id}/sectionGroups
Create sectionGroup
New-MgUserOnenoteSectionGroupSection /me/onenote/sectionGroups/{id}/sections
Create section
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-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
New-MgBetaUserOnenoteNotebook /me/onenote/notebooks
Create notebook
New-MgBetaUserOnenoteNotebookSection /me/onenote/notebooks/{id}/sections
Create section
New-MgBetaUserOnenoteNotebookSectionGroup /me/onenote/notebooks/{id}/sectionGroups
Create sectionGroup
New-MgBetaUserOnenoteSectionGroupSection /me/onenote/sectionGroups/{id}/sections
Create section

Code Examples

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

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new Notebook
{
	DisplayName = "My Private notebook",
};

// 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.PostAsync(requestBody);
JavaScript
Create notebook
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

const notebook = {
    displayName: 'My Private notebook'
};

await client.api('/me/onenote/notebooks')
	.post(notebook);
PowerShell
Create notebook
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Notes

$params = @{
	displayName = "My Private notebook"
}
# A UPN can also be used as -UserId.
New-MgUserOnenoteNotebook -UserId $userId -BodyParameter $params
Python
Create 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
from msgraph.generated.models.notebook import Notebook
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Notebook(
	display_name = "My Private notebook",
)

result = await graph_client.me.onenote.notebooks.post(request_body)

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.Create

4

Grant Admin Consent

Users can consent to this permission during sign-in.