Automate OneNote Class Notebook creation and roster changes with new APIs

OneNote Class Notebooks are a hugely popular tool used all over the world within education. With many features and aspects designed specifically for use in academic scenarios, the continued evolution of OneNote in Education is moulded in a large part by the feedback the OneNote team receives from teachers and education IT professionals.

OneNote logo

With this in mind, the latest update to the OneNote Class Notebook is another of those inspired directly by the requests and suggestions received from educators and IT admins, and this time is all about the way in which Class Notebooks can be created and administered on a school- or district-wide scale.

The following is an extract from the original post by the OneNote Team on the Office Blog:


Automate OneNote Class Notebook creation and roster changes with new APIs

by OneNote Team, on February 17, 2016

We are excited to announce the launch of the new OneNote Class Notebook API for Office 365! Since the launch of OneNote Class Notebooks last year, the only way to create Class Notebooks was through the OneNote Class Notebooks Office 365 app. Thanks to all the feedback we’ve received from teachers and IT admins, we made it possible to now create OneNote Class Notebooks programmatically as well. What this means is that IT admins, Microsoft Education Partners and others can automate the creation and updates of OneNote Class Notebooks across a school or district. This allows for large time savings and efficiency for teachers, as well as school IT staff.

Read the MSDN article on the OneNote Class Notebook API for in-depth instructions.

OneNote Class Notebook

What does the API do?

Anyone familiar with the existing OneNote API for Office 365 will find themselves right at home with the OneNote Class Notebooks API for Office 365. Like the OneNote Class Notebooks Office 365 app, the only requirement for teachers is that they have an Office 365 faculty license and their OneDrive for Business is set up.

But how does this API help me, you ask? Suppose you are the IT admin of your school. Wouldn’t it be great if teachers came in on the first day of the new semester and found that a OneNote Class Notebook has been created for all of their classes and with all of their students? With the new OneNote Class Notebooks API, you can do just that! If you have the rosters of your teachers handy (perhaps you pulled it from your school’s SIS or it’s stored in an Excel/CSV file), all you need is a simple script that calls the OneNote Class Notebooks API to create OneNote Class Notebooks for every teacher.

To view some example scripts, please refer to the original post on the Office Blog.

Partner opportunities

With these new APIs, we envision lots of new ideas and solutions built by our Microsoft Education Partners. We have heard a strong demand for new tools and solutions to help schools roll out OneNote Class Notebooks, and our partners have expressed a desire to help provide these. Head over to GitHub for sample code to get started.

Send us your feedback

We’d love to hear from you any suggestions or questions you might have. Simply drop us a line at

Comments (1)
  1. Richard Willis says:

    This is great. We've now added support for creating and maintaining Class Notebooks to our products.…/onenote-class-notebook-creation-with-salamander-active-directory-and-sharepoint

Comments are closed.

Skip to main content