Default Note Location

Default Note Location

Rate This
  • Comments 6

Hello, I am Di Ye, a program manager on the OneNote Team and I am writing to share where we put the content your Apps create in users' OneNote notebooks.

Where can users find their content created through the API?

In OneNote, all information is stored in a hierarchy that looks like this: Notebook >> Section Group (optional) >> Section >> Page.

Each POST to the pages endpoint creates a new page in your users' default section in their default notebook. As OneNote has been around quite a long time, the names of these have evolved somewhat, so it's a bit more complex than we'd like.

  • If your users are pretty new to OneNote, they’ll find their content in the Quick Notes section of <User's First name>’s Notebook on OneDrive.
  • If your users have been using OneNote for a while, their notebooks may have a different name, like Personal, Personal (web), or My Notebook and their content will be in the Unfiled Notes section.

Can you create content into a specific notebook and section?

There's currently no way via the API to select a specific notebook and section for content to be created into. All created content will go to the users' default notebook and section.

However, we are already hard at work extending our API to expose all of a users' notebooks and sections and allow you to specify where to create content for a user. We expect this to be functional in the next few months and will be asking you for feedback here as we design this.

How can you tell your users where to find the created pages?

If you are building an app or service with a UI, we encourage you to expose one of the deep links to the newly created page that are returned from each POST. These links allow your users to launch the OneNote client or OneNote Online on their device and immediately view the new page. Check out how to embed a deep link in your client.

There is also an article targeted at end users here that you can use to help your users figure it out where their default notes are stored.


Leave a Comment
  • Please add 3 and 6 and type the answer here:
  • Post
  • I have just tried out the new API on windows phone, and it works like a charm!  I would love for my app to be able to create an app-specific notebook with sections also created by the app.  My customers are most likely not OneNote users, so I need to make it as turnkey (simple) for them as I can.

    Thanks for giving us such a great capability!

  • @Karen - Yup - this is something we want you to be able to do to. This should be coming soon after we update the ability to specify what notebook and section you want to put a note into.

  • might be worth noting that changing the default location for new notes in OneNote on Windows Phone doesn't change the default location used by the API (I'm glad it doesn't, would have been a real pain, but people might expect that)

  • OneNote seems to have set an old Notebook as the default location. I can't find anywhere how to change that. Would deleting (and re-importing somehow) that Notebook help? If this is not possible yet, do you know when it will be?

    I am using the OneNote on Android KitKat and it sends the notes to the notebook OneNote has somehow decided (wrongly) to be default.

    Any advice?


  • Any way to change the default notebook to something other than the personal notebook created when first used?

  • I have the same question as Sebastian. I've gone into the settings and changed all the default locations for OneNote yet using IFTTT new content goes to my Personal/Quick Notes folder. Not a huge deal as I can change my processes but it would be amazing if we could change the location of where new pages are created. So far I'm impressed. As an avid David Allen GTD follower OneNote combined with IFTTT is just the solution I've been looking for!

Page 1 of 1 (6 items)