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.

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. Markdown Support for OneNote (desktop and web)

    I know there's already an Idea posted for this topic however the original poster of the idea hasn't provided feedback as to what exactly they meant. so here goes:

    It's simply the ability to use Markdown in OneNote pages, Currently I use the tool to take all of my work notes, and as a Developer I need to add code blocks, code lines and other formatting into my notes,. It would be great if Markdown was added to OneNote just like in GitHub wikis or Stackoverflow for example as I would hate moving away from using it!

    463 votes
    Vote
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      I agree to the terms of service
      Signed in as (Sign out)
      You have left! (?) (thinking…)
      2 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
    • Expose the complete Object Model of Onenote

      The OneNote API should be the API that the Microsoft team that develop OneNote themselves uses.
      There should not be anything that Microsoft can do that a 3:ed party could not do as well.

      There should be a set of basic classes/objects that remain fairly stable over time and then just about everything else should be addons.
      Check out how Visual Studio is done, and then do something similar with OneNote.

      At the very foundation OneNote is nothing but a distributed and replicated Database, so creating new data models/structures should be a trivial thing.
      There could be requirements that there…

      12 votes
      Vote
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        I agree to the terms of service
        Signed in as (Sign out)
        You have left! (?) (thinking…)
        0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
      • Mind Maps. , would be great to be able to create mind maps in One Note

        It would be helpful to create basic mind maps in one note. I appreciate I could draw one, but not very professional to export or share.

        18 votes
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          I agree to the terms of service
          Signed in as (Sign out)
          You have left! (?) (thinking…)
          0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
        • 16 votes
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            I agree to the terms of service
            Signed in as (Sign out)
            You have left! (?) (thinking…)
            0 comments  ·  Flag idea as inappropriate…  ·  Admin →
          • Update link text from "Link to Paragraph"

            Right click on a text and you will have option to "Copy Link to Paragraph".
            Paste the link somewhere.
            Change the original text.
            Automatic update of the pasted link would be great.

            2 votes
            Vote
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              I agree to the terms of service
              Signed in as (Sign out)
              You have left! (?) (thinking…)
              0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
            • should be allowed to set reminders

              set reminders for notes

              3 votes
              Vote
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                I agree to the terms of service
                Signed in as (Sign out)
                You have left! (?) (thinking…)
                0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
              • Add-In Ink Support

                Allow OneNote add-ins to access ink position data (height, width, x, y and type - highlight, ink stroke, etc.) Current implementations only allow for getting id. Not very useful.

                Stack Overflow Link: http://stackoverflow.com/questions/43809841/onenote-inkstroke-floatingink-api/43900155#43900155

                1 vote
                Vote
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  I agree to the terms of service
                  Signed in as (Sign out)
                  You have left! (?) (thinking…)
                  0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                • Webhooks via Graph API

                  Please add webhooks on Graph API.

                  I assume this is on the roadmap, but there is nothing mentioned. There are several gaps that make moving to graph (and supporting business notebooks) difficult.

                  So far, we cannot get webhooks or update pages via Graph. Some indication that we will be able to soon support these features would be great.

                  3 votes
                  Vote
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    I agree to the terms of service
                    Signed in as (Sign out)
                    You have left! (?) (thinking…)
                    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                  • Delete completed tasks

                    It would be so helpful for tasks to disappear when they are completed. I can't believe this isnt an option.

                    1 vote
                    Vote
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      I agree to the terms of service
                      Signed in as (Sign out)
                      You have left! (?) (thinking…)
                      0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                    • scan from hp scanner directly to onenote

                      Would like to scan directly from my HP all in one printer-scanner into onenote.

                      3 votes
                      Vote
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        I agree to the terms of service
                        Signed in as (Sign out)
                        You have left! (?) (thinking…)
                        0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                      • calender

                        a calender available would be extremely useful?

                        5 votes
                        Vote
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          I agree to the terms of service
                          Signed in as (Sign out)
                          You have left! (?) (thinking…)
                          0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                        • Bullet Journal

                          Create an API that would incorporate the Bullet Journal system.
                          More details can be found on the website below. I recommend contacting Mr. Ryder Carrol directly to help develop it.

                          http://bulletjournal.com.

                          9 votes
                          Vote
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            I agree to the terms of service
                            Signed in as (Sign out)
                            You have left! (?) (thinking…)
                            1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                          • Add OneNote add-ins to OneNote API compatible ids

                            It is hard to match things in add-ins when using the API because the id's are different. There are many cases where making API calls from an add-in is useful!
                            http://stackoverflow.com/questions/40491066/difference-between-notebook-id-by-officejs-and-onenote-api
                            Please add support for compatible id's!

                            35 votes
                            Vote
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              I agree to the terms of service
                              Signed in as (Sign out)
                              You have left! (?) (thinking…)
                              3 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                            • Add timestamps for all non-persistent entities: PrincipalObject, Permission, etc

                              For the normal implementation of cache it is important to have some preparations on the server-side, e.g. if-modified-since header, $filter with lastModifiedTime or something like this. But, unfortunately they require timestamps on the server time to improve the synchronization between client and server. So, my idea is to add the timestamps for all of the non-persistent entities including permissions and primary objects.

                              1 vote
                              Vote
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                I agree to the terms of service
                                Signed in as (Sign out)
                                You have left! (?) (thinking…)
                                0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                              • my password of quick note section in OneNote has been forgotten. How can I solve it?

                                my password of quick note section in OneNote has been forgotten. How can I solve it?

                                1 vote
                                Vote
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  I agree to the terms of service
                                  Signed in as (Sign out)
                                  You have left! (?) (thinking…)
                                  0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                                • Just have one OneNote for each platform with all features.

                                  It's fiddly having OneNote and OneNote 2016 each sharing some functions but not all. One OneNote for each platform would be great.

                                  10 votes
                                  Vote
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    I agree to the terms of service
                                    Signed in as (Sign out)
                                    You have left! (?) (thinking…)
                                    0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                                  • Give the option to limit the page size to fit the screen size

                                    Although the possibility to write everywhere on the page is really cool it would be awesome to have the ability to keep the size of the page (in terms of actual width and lenght) (like A4/A5/letter format etc but pre-customized to fit the screen perfectly).
                                    This would prevent people to accidentally move in the page loosing sight of what they had written.

                                    6 votes
                                    Vote
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      I agree to the terms of service
                                      Signed in as (Sign out)
                                      You have left! (?) (thinking…)
                                      0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                                    • medical

                                      i am a doctor in England UK National Health Service - we currently use MS on www.nhs.net our secure email service.
                                      I would like to speak to your development team regarding a medical extension that could be very lucrative new arena for you. vnaidoo@nhs.net Cel: +447900947733 or vishalnaidoo@hotmail.com

                                      4 votes
                                      Vote
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        I agree to the terms of service
                                        Signed in as (Sign out)
                                        You have left! (?) (thinking…)
                                        0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                                      • API bug of Input HTML when creating new pages with non-contributing default div

                                        Hi,

                                        Just came across this bug when trying to create an empty page and append content to it later through data-id.

                                        The HTML I used to create the empty page is:
                                        <!DOCTYPE html>
                                        <html>
                                        <head>
                                        <title>some title generated</title>
                                        <meta name="created" content="some time string generated" />
                                        </head>
                                        <body>
                                        <div data-id="_clippings"></div>
                                        </body>
                                        </html>

                                        The page was created successfully but when I tried to update it later, the response is data-id not found.
                                        So I tried to get the HTML body of the page created and it was like this:
                                        <html lang="en-US">
                                        <head>
                                        <title>test without content</title>
                                        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
                                        <meta name="created"…

                                        1 vote
                                        Vote
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          I agree to the terms of service
                                          Signed in as (Sign out)
                                          You have left! (?) (thinking…)
                                          0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                                        • link to specific paragraph

                                          Allow OneNote JS API to create a link to a specific paragraph inside the page.
                                          1. On a paragraph add a method to get a link to it
                                          2. Add API that allows to navigate directly to that. If it is the current page, simply scroll that paragraph into position. if it is a different page - go to that page and scroll.

                                          Note: In OneNote desktop version this works in the UI, simply by right clicking any paragraph and copy link to paragraph. In OneNote web these links do nothing.

                                          This will allow devs to build table of contents…

                                          6 votes
                                          Vote
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            I agree to the terms of service
                                            Signed in as (Sign out)
                                            You have left! (?) (thinking…)
                                            0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                                          ← Previous 1 3 4 5 10 11
                                          • Don't see your idea?

                                          OneNote Developer APIs

                                          Feedback and Knowledge Base