OneNote Developer APIs

Welcome to the feedback forum for OneNote’s developer platform and APIs! This is the place for developers to send us feedback and suggestions. To share feedback about OneNote’s apps, please visit our user forum instead. For “How To” questions, please visit StackOverflow.

We have partnered with UserVoice, a third-party service and your use of the portal and your submission is subject to the UserVoice Terms of Service & Privacy Policy, including the license terms. Please do not send any novel or patentable ideas, copyrighted materials, samples or demos for which you do not want to grant a license to Microsoft.

  1. OneNote UWP add-in API

    OneNote UWP add-in APIs are essential to a successful OneNote-Office transition to UWP. Office-OneNote add-in capability have a healthy ecosystem for customized user-developer functionality, such as Onetastic, OneNote UWP add-in APIs should be sustained to empower users-developers to provide unusual or domain specific functionality, which can quickly be developed and deployed to meet domain-specific user-needs and become candidates for eventual OneNote PWS integration. As an example, an Office-OneNote healthcare Electronic Medical Record (EMR) set of macros is used for clinicians to maintain patient records for small medical practices. Losing OneNote Office API integration decreases the Microsoft value proposition.

    313 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    7 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  2. Implement copytosection, copysection, copynotebook for consumer OneNote via Graph

    Please support the above operations for OneNote Notebooks hosted on Consumer OneDrive. Currently these return 'Not Implemented' although the documentation suggests that they should work.

    6 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  3. HTML last-modified-time and last-modified-by data attributes

    Additional HTML object attributes that identify when specific segments were last modified and by whom e.g. last-modified-time=* last-modified-by=*

    This would greatly expand the development possibilities for the REST API (such as user-contribution tracking), bringing it in line with what was possible with the C# applications developed for the desktop version of OneNote.

    3 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  4. API to list notebooks in sharepoint site even if the site has more than 20000 items in it

    API can have a "search by displayName" feature instead of restricting the API to be used if share point has more than 20000 items in it or at least it can provide a paginated response

    1 vote
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  5. ODATA 'search' for OneNote Business

    I was somewhat shocked when an API tech told me you can't search OneNote Business pages via the API to find the note you need to retrieve or modify.

    I'm sure there are some permissions concerns, but without being able to search using the API is extremely inefficient and not really usable for many purposes.

    Please prioritize giving your paid business customers the same features as your free consumers can get.

    62 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    10 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  6. Requests throttling (suggested API call rate)

    What is the suggested maximum OneNote API call rate (API requests per second) over thousands of API requests - in order to NOT get throttled by the service.

    Or, put it in another way, that is the minimum suggested interval between single OneNote API requests, in order to avoid throttling - over thousands of requests needed to be made?

    I would implement this throttling in my client-side code, but any reasonable call rate I've experimented with, currently still leads to throttling, beyond 1000 requests performed.

    My use case is this: I need to mass-import data from OneNote notebooks under an…

    15 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  7. BUG: REST API - Getting page collection of a section returns deleted pages

    I noticed that requesting a page collection from a section will return a response with pages that were deleted already. This does not always occur. In my scenario I deleted pages from the OneNote web app and made a call to the following endpoint:

    https://www.onenote.com/api/v1.0/me/notes/sections/{section-id}/pages/

    Both current and deleted pages were returned in the response.

    4 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    2 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  8. Webhooks for Office 365 Notes

    Webhooks now work for OneDrive accounts which is great, but we've got Office 365 Business clients clamoring for the same functionality. I know there are privacy and access concerns to be addressed here, but Evernote solved them and I'm sure Microsoft will too.

    It's always tough when paying Business users feel behind free users in functionality. Hope this can be addressed soon.

    110 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    8 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  9. Solve the error code: 10013

    Solve the error code: 10013 removing the limit of 20000 items in onedrive (as well as the error with the limit of 5000 item in onenote)

    25 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  10. Onenote tags

    I am syncing OneNote notebooks into my application using MS graph API. Onenote has few tags like To-Do, Important, Question etc. When I fetch html content for particular page these tags comes as data-tag like in -

    <p lang="en-US" data-tag="important" style="margin-top:0pt;margin-bottom:0pt"><span lang="en-GB">Abc</p>
    How can I replace these tags with the icon with which they are represented in OneNote UI. If I think to skip these tags the notes look very weird.

    There has to be rest api which gives you binary content or some metadat information about tag provided tag type (name) like to-do

    13 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  11. Add createdBy, createdDateTime, lastModifiedBy and lastModifiedDateTime to individual page elements via OneNote Graph API

    OneNote definitely has author information about individual edits within a page (i.e. individual divs or whatever), as this can be viewed through the API. We would like this information through the Graph API.

    11 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  12. API to identify deleted notebooks/sections/groups IDs

    Existing API's do not provide a way to identify deleted notebooks/sections/pages. Request you to provide an API to provide the list of items got deleted from a given date.

    This will be useful in case of offline apps where it syncs periodically to OneNote server.

    6 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  13. API support for page versionning

    It should possible take a backup copy of page using the same mechanism as the application built-in versioning mechanism.
    Eg. Before modying a page with the Rest API.

    6 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  14. Search/Filter using data-tags (like data-tag="to-do")

    I am developing a script which will copy all the content from several pages having " data-tag='to-do' ". It would be much easier to fetch the particular contents of the page by filtering it using onenote tags. But currently I have to access each and every page as such features are not yet available in API.
    Please enhance the filters by implementing filter using OneNote tags.

    40 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  15. notebook color

    Add a 'color' property to the 'notebook' object.

    With a 'color' property, apps developed with the API could present a more uniform experience across different devices and domains.

    7 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  16. API to delete page content

    There is no way to delete some content from a page with the API. Such as in this example:

    <body>
    <div id="div:{681ddef6-e8ad-0de3-2439-dcc668303696}{34}">
    <p id="p:{f5837c83-d816-4337-ab6d-a52abde869a6}{13}">Delete me</p>
    <p id="p:{1710a020-7fa3-46cb-a8ab-64209696e083}{14}">Keep me/p>
    </div>
    </body>

    We should be able to have a PATCH request with the following instruction:
    [{
    'target': 'p:{f5837c83-d816-4337-ab6d-a52abde869a6}{13}',
    'action': 'delete',
    },
    ]

    9 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  17. Ability to reorder page

    Ability to set order of the page created and reorder of the pages would be useful

    47 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    3 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  18. Custom data attributes (data-custom-*) per element

    Support for data-* attributes with custom names would be great.

    It would allow keeping 3rd party application specific metadata along elements. This would enhance sync possibilites with external systems.

    These attributes would be not interpreted by OneNote but persisted. Now I tested it and these attributes are thrown away when doing roundtrip via OneNote API.

    Currently, there is only data-id attribute which is great but not offering much flexibility.

    These new attribute could have extra prefix e.g. data-custom-* not to collide with your internal attributes..

    8 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  19. Section & page ordering: matching desktop versions

    To improve the user experience can the API please allow us to order section and pages to match what the user's desktop client ordering is? Or at least provide an orderby option for this?

    I assume that this information is available? I don't have to re-order all my information on iOS client or desktop client if I install from scratch. The OneNote web client knows the order of sections & pages. Can the API too please

    9 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  20. Ability to POST(create) multiple sections at once and/or determine section order

    When creating multiple Notebooks with multiple default sections a huge number of requests are required. Even using curl_mutli_exec it seems time consuming. The order the sections end up being displayed is fairly random as well via this approach.

    8 votes
    Vote
    Sign in
    (thinking…)
    Sign in with: Facebook Google
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    2 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
← Previous 1 3 4
  • Don't see your idea?

OneNote Developer APIs

Categories

Feedback and Knowledge Base