OneNote API Reference

Find documentation about the OneNote API REST interface.

Last modified: September 15, 2014

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

HTML

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.