OneNote API

Microsoft OneNote API enables developers to write apps on many different platforms and device-types that create and manipulate user's information stored in Microsoft OneNote. This topic presents a running list of recent updates we've made to the API and documentation.

Last modified: August 25, 2014

Applies to: OneNote service

Welcome to our API! If you have any questions or other input on the API or documentation, please feel free to come join us in the communities listed near the bottom of the Getting started with the OneNote API topic. We look forward to hearing from you, and hope you find the API and documentation useful.

July, 2014

We added these reference pages for additional capabilities:

June, 2014

Revamped format for OneNote API Reference section.

Week of April 29, 2014, minor update

In our first update, we've completed a couple of handy features for developers writing apps that work with PDF documents or that want captures to go to a specific notebook section:

  • PDF rendering as images directly on the OneNote page. With this update, when you add an <img data-render-src="name:BlockOfPDFData"/> the OneNote API will render the PDF pages as images, and insert them onto the page. Common practice is to also embed the PDF file onto the page, and you can do that with the <object data-render-src="name:BlockOfPDFData"/> tag. You can even reference the same BlockOfPDFData for both tags. Prior to this update, you could embed the file on the page, but not yet render the images from the same PDF data. For more, see the article on how to Capture and embed PDF files with the OneNote API.

  • Create pages in specific sections by including the sectionName query parameter in your pages POST requests. If the top-level section name you provide doesn't exist, the API will create it. With this new feature, your app can store captures in an easily-recognized section. You can learn more at Capture pages in a specific section using the OneNote API

We made these updates to the documentation:

March 17, 2014, Initial Release

Here are the current highlights of the OneNote API:

  • The API version 1.0 is now available for your use! The main REST endpoint is The only resource path available now is /pages, but we've got big plans for more!

  • At initial release, the API supports creating new OneNote pages using HTML to define the page. You can include images, and embed other binary file types (up to 25MB per file, 75MB per page total) on each OneNote page. The API can take a snapshot of Web pages and include the page as an image on the OneNote page. It also performs OCR on images your app captures.

  • Before your app can work, it needs to have either a client ID, or if you're making a Windows 8 Store app, it needs to have a package ID. You can find full information at Get a client ID for use with the OneNote API.

  • In addition, the OneNote API requires the user of your app have a Microsoft Account. They don't need to be using a Microsoft device, but need a Microsoft account. For more information about using the Windows Live Connect SDK, see Authenticate the user for the OneNote API.

The initial set of documentation includes the following sections:

We're always grateful to hear from you about issues you find in the docs, and whether they give you what you need. The API is intended for both experienced and new app developers, so let us know how we're doing.

© 2014 Microsoft