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.
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.
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 way to change the default notebook to something other than the personal notebook created when first used?