Share via


OneNote API Reference

Find documentation about the OneNote API REST interface.

Applies to: OneNote service

In this article
Root URI
/pages
/sections
/sectiongroups
/notebooks
Additional resources

The Microsoft OneNote API enables developers to create innovative, multi-platform apps that use OneNote and help people organize their life. This section provides reference material for the REST-based API. For platform-specific code examples, see the Develop with the OneNote API section.

Root URI

HTTPS://www.onenote.com/api/v1.0/

/pages

Pages are the basic units of a OneNote notebook.

Verb/Topic

Description

POST

Creates a new OneNote page by passing a block of HTML in the body.

POST /sections/{section ID}/pages

Creates a new OneNote page inside a specific section.

OneNote API HTML tag support

Lists the HTML subset that is supported on OneNote pages.

/sections

Sections are collections of pages in a OneNote notebook.

Verb/Topic

Description

POST /notebooks/{notebook ID}/sections

Creates a new section inside a specific notebook.

GET

Gets the sections to which a user has access.

GET /notebooks/{notebook ID}/sections

Gets the sections inside a specific notebook to which a user has access.

GET /sectiongroups/{section group ID}/sections

Gets the sections inside a specific section group to which a user has access.

GET /sections/{section ID}

Gets a specified section.

/sectiongroups

Sections groups are collections of sections in a OneNote notebook.

Verb/Topic

Description

GET

Gets the section groups to which the user has access.

GET /notebooks/{notebook ID}/sectiongroups

Gets the section groups inside a specific notebook to which a user has access.

GET /sectiongroups/{section group ID}/sectiongroups

Gets the section groups inside a specific section group to which a user has access.

GET /sectiongroups/{section group ID}

Gets a specified section group.

/notebooks

Notebooks contain sections, section groups and pages.

Verb/Topic

Description

POST

Creates a new notebook.

GET

Gets the notebooks to which the user has access.

GET /notebooks/{notebook ID}

Gets a specified notebook.

Additional resources