OneNote is a note-taking and organizational app that is available across all major platforms and as a web app. It allows users to store notes, photos, videos and other documents in the cloud for access anywhere. The OneNote API allows developers to build apps that integrate with OneNote by saving content to notebooks and querying user notes programmatically. Future apps will be able to leverage implicit capture of user data from various sources and use OneNote's search and storage to provide more personalized experiences by understanding user interests and preferences.

2. 

•
•
•


•
•
•

3.  Free on all platforms
• Windows
• Windows Phone
• Mac OS X
• iOS
• Android and Android Wear
• And on the web with OneNote Online
 Pre-installed with every new Windows device
 New 1st party experiences
• Office Lens for WP: Your pocket scanner. Fixes, enhances, and makes pictures readable
• OneNote Clipper: Clip the web using your favorite browser
• me@onenote.com: Emails saved to OneNote
 10’s of millions of users
 15 GB of free storage with OneDrive
 No upload quota

4. Lightweight, simple, and available anywhere
RESTful CRUD API for Notes
Built on JSON, HTML, and OData
Find anything quickly
Entity recognition, image/audio/video processing, schematized content and metadata
Full text search and structured queries
Natural language search
Your memory store in the cloud
One place for all your memories. Never forget anything again.
Effortlessly evoke your memories whenever you need them
Enable more personalized devices, apps, and smarter digital assistants
Enable next gen apps to start bridging personal data silos

5. Our Partners

6. Make your existing apps more personal
Tap into users notes and memories and improve your app experience using the power of full text search
Leverage data saved by other apps and devices
E.g. A restaurant app can make better suggestions based on previously visited restaurants or recipes saved to OneNote.
A retail app can notify users when items they saved to OneNote go on sale.
Use OneNote to increase your app usage
Enable users to save content for later to OneNote from within your app.
Use OneNote’s powerful canvas to create captivating layouts that link users back to your app when they search their
memories in OneNote.
OneNote as a data feed
Surface domain-specific data like products, recipes, web sites, shopping lists, todo items, news articles, etc. in OneNote
within the context of your app experience.
E.g. news reader apps, todo apps, health apps, food/restaurant apps, photo apps, etc.

7. Available today
• Create page in default location
• Create page in specific location
• Query notebooks, sections,
and section groups
• Create notebooks and sections
• PDF Rendering
• Query pages*
• Get page content*
• Todo tags*
Available soon
• Patch page
• Append/prepend
• Full text search
• Page thumbnails
• Query images
• Notebook sharing
Planned
• Office 365 support
• Natural language search
• Query for common
entities

8. OneNote API != Database Service
Save captivating content for users to view and annotate in OneNote
Not likely the best store for machine data like XML, JSON, etc. or large media like HD
movies.
OneNote is a store for notes and memories
Store relevant pieces of content that link OneNote users back to your app
Store notes, todo lists, websites, receipts, workout summaries, annotations, etc.
Account for end users modifying and deleting pages saved by your app
Not likely the primary store for most apps.
A great data source for apps to make better decisions and a contextual entry point for
your app.

10. Simple, simple, simple to use
Works as you would expect
 Standard HTTP verbs on resource endpoints: ~/notebooks, ~/sections, ~/pages
 Restful notation: ~/notebooks/{id}, ~/sections/{id}/page
Use your favorite HTTP request and JSON parsing libraries (jQuery, JSON.NET,
etc.)
You don’t have to learn a new query language
 OData v4 verbs such as filter, select, orderby, etc. all work as expected
OAuth made easy
No OAuth knowledge required. Libraries available for most popular platforms
Register your App with Windows Live and append the access token to the
request headers

11. WL.Event.subscribe("auth.login", onLogin);
WL.init({
client_id: 'YOUR CLIENT ID GOES HERE',
redirect_uri: 'YOUR APP REDIRECT GOES HERE',
scope: ["wl.signin", //wl sign in access
“wl.offline_access", //if your app needs to refresh the token
"office.onenote", //read access to all pages
"office.onenote_create", //create pages in any location
"office.onenote_update_by_app", //edit pages modified by app
"office.onenote_update" //full access to all pages and notebooks
],
response_type: "token"
});

12. WL.Event.subscribe("auth.login", onLogin);
WL.init({
client_id: 'YOUR CLIENT ID GOES HERE',
redirect_uri: 'YOUR APP REDIRECT GOES HERE',
scope: ["wl.signin", //wl sign in access
“wl.offline_access", //if your app needs to refresh the token
"office.onenote", //read access to all pages
"office.onenote_create", //create pages in any location
"office.onenote_update_by_app", //edit pages modified by app
"office.onenote_update" //full access to all pages and notebooks
],
response_type: "token"
});

13. function onLogin(session) {
if (!session.error) {
//extracts the token from the cookies
access_token = getAccessToken();
$.ajax({
accept: "application/json",
type: "GET",
url: "https://www.onenote.com/api/v1.0/notebooks",
//appends the access token to the request
headers: { "Authorization": "Bearer " + access_token },
complete: function (data, status, xhr) {
$(“#response").text(data.responseText);
}
});
}
}

14. A
p
p
s
API Surface
Save to OneNote – News360, Feedly, Neat scanner, IFTTT action
Enumerate hierarchy – Location pickers
Query pages and get content- Query pages, display page content within your app or open page in
OneNote, IFTTT triggers (coming soon)
Implicit capture – Journal and event apps, health apps for wearables, smart appliances, etc.

15. A
p
p
s
API Surface
Save to OneNote – News360, Feedly, Neat scanner, IFTTT action
Enumerate hierarchy – Location pickers
Query pages and get content- Query pages, display page content within your app or open page in
OneNote, IFTTT triggers (coming soon)
Implicit capture – Journal and event apps, health apps for wearables, smart appliances, etc.
OneNote as a source for user memories– Get images, documents, recipes, news, articles, business cards,
location info, etc. captured by other 3rd party apps and build beautiful vertical experiences.
Take advantage of full text search with spell correction to find relevant content

16. A
p
p
s
API Surface
Save to OneNote – News360, Feedly, Neat scanner, IFTTT action
Enumerate hierarchy – Location pickers
Query pages and get content- Query pages, display page content within your app or open page in
OneNote, IFTTT triggers (coming soon)
Implicit capture – Journal and event apps, health apps for wearables, smart appliances, etc.
OneNote as a source for user memories– Get images, documents, recipes, news, articles, business cards,
location info, etc. captured by other 3rd party apps and build beautiful vertical experiences.
Take advantage of full text search with spell correction to find relevant content
Intelligent more personal Apps and devices – Build smarter apps that naturally help users get more done:
• Digital assistants will use the API to bring up the list of groceries if passing by the market
• Next gen appliances will show a list of recipes in my cookbook I can make with the ingredients I have
• Restaurant apps know about my food preferences and use them to suggest a list of restaurants

18. What did we learn?
Implicit capture apps are the future
Smart and un-obtrusive. They add value without requiring explicit user action.
Users don’t want to enter data. They want to use it - annotate, learn, and act on it.
Mimic how humans effortlessly remember and evoke memories
OneNote is the best place to store user memories
Next-gen apps will add more value while requiring less
human input
New natural interfaces and devices such as wearables and smart appliances will require less and less
human interaction. They will be configured to capture data in response to specific stimuli.
Draw insights from captured data with the purpose of helping users:
 Do more and more efficiently
 Stay healthier and reach their activity goals
 Suggest places to eat, movies to watch, recipes to try, etc. based on their interests

19.  OneNote = Your notes available anywhere
 OneNote + API = Your memories available
anywhere
 Increase your app usage by saving to OneNote
 Help us make OneNote the place for users to
remember anything
 Build more personal apps with the OneNote API

20. Apiary console: http://dev.onenote.com/dev/docs
Apigee console: https://apigee.com/onenote/embed/console/onenote
Beta features and news: http://blogs.msdn.com/b/onenotedev/
API documentation: http://msdn.microsoft.com/en-us/library/office/dn575425.aspx
Code samples: https://github.com/OneNoteDev
Feature requests and feedback: https://onenote.uservoice.com/forums/245490-
onenote-developers
Issues and technical questions: http://stackoverflow.com/questions/tagged/onenote
Social: https://twitter.com/onenotedev
API roadmap: http://blogs.msdn.com/b/onenotedev/archive/2014/03/25/onenote-api-
near-term-backlog.aspx
Email: ivenado@microsoft.com

21. Session feedback: http://aka.ms/omar