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.

How can we improve the OneNote APIs and developer platform? Vote for an existing idea or share a new one.

You've used all your votes and won't be able to post a new idea, but you can still search and comment on existing ideas.

There are two ways to get more votes:

  • When an admin closes an idea you've voted on, you'll get your votes back from that idea.
  • You can remove your votes from an open idea you support.
  • To see ideas you have already voted on, select the "My feedback" filter and select "My open ideas".
(thinking…)

Enter your idea and we'll search to see if someone has already suggested it.

If a similar idea already exists, you can support and comment on it.

If it doesn't exist, you can post your idea so others can support it.

Enter your idea and we'll search to see if someone has already suggested it.

  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.

    204 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    3 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  2. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  3. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  4. 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.

    61 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    10 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  5. 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.

    107 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    8 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  6. 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)

    13 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  7. 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.

    5 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  8. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  9. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  10. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    3 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  11. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  12. 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…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  13. Ink support in the API

    Be able to support something like InkML in OneNote pages through the API.

    121 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    15 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  14. Documentation on how to create and update nested lists in onenote pages.

    Currently I cant get nested lists to be updated or created. Can you please provide better documentation.

    1 vote
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  15. BUG: REST API - MathML is repeated throughout a page

    When retrieving a page with MathML content, the math tags are repeated for every equation. The first instance is in the correct position, and the second is usually at the end.

    3 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  16. 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…

    6 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  17. 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.

    1 vote
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  18. insert sharepoint form in onenote

    Hi,
    I would like to create fields in OneNote page who would inform a SharePoint Library.

    9 votes
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  19. Get/Put RAW page data

    Hi,

    I want to get and put the raw data for a page, so that I don't have to parse the HTML rendered page and download the resources, and maybe have to wait for another API for supporting Ink or other extension generated data. And I'd like to avoid generate multipart http request just to restore what I downloaded.

    And want this integrated to MS GRAPH API C# DLL so that I don't have to create raw http(s) request.

    1 vote
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  20. Make tags on the entire note available through the API

    Although OneNote tags on page elements (e.g. <p>) show up in the HTML content returned via the REST API prefixed with a data-tag attribute, tags on the entire note are not returned.
    Jorge Aguirre believes that the right way of representing this information is to add the data-tag attribute to the HTML->head->title element.
    More about this feature (or rather, current lack of it) at:
    https://stackoverflow.com/questions/47025309/any-way-to-get-the-tag-on-a-note-not-just-a-page-element-via-onenote-rest-api

    1 vote
    Vote
    Sign in
    (thinking…)
    Password icon
    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
← Previous 1 3 4
  • Don't see your idea?

OneNote Developer APIs

Feedback and Knowledge Base