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. Allow OneNote notebooks to exist in Onedrive/O365 and also be replicated on a local server on a site.

    OneNote API is for the Onedrive onenote, The COM API is for desktop onenote.

    I would like to write an app that would offer the flexibility of having onenotes online (onedrive/etc) but also having the peace-of-mind of having a local copy on a server for a site to work on so they don't get lag and also still have the notebooks if their internet dies.

    I .. I don't think this is possible right now.

    20 votes
    Vote
    Sign in
    Check!
    (thinking…)
    Reset
    or sign in with
    • facebook
    • google
      Password icon
      Signed in as (Sign out)
      You have left! (?) (thinking…)
      3 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
    • make it less soul-crushingly awful to create COM add-ins.

      Take a queue from Google and "don't be evil." You're current approach to COM add-ins in OneNote is downright diabolical.

      3 votes
      Vote
      Sign in
      Check!
      (thinking…)
      Reset
      or sign in with
      • facebook
      • google
        Password icon
        Signed in as (Sign out)
        You have left! (?) (thinking…)
        0 comments  ·  Flag idea as inappropriate…  ·  Admin →
      • allow organsing in better manner

        i am a reasercher into notes application,i have found that hiraricial folders to 5+-2 is the best amount of nested folders to be allowed in any app to organize information,right now onenote allows section groups>>sections>>pages>>subpages,plz improve this with the help of folders,that can go upto 7 levels if needed

        0 votes
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          Signed in as (Sign out)
          You have left! (?) (thinking…)
          3 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
        • recognize bluetooth pencil in onenote (ipad)

          See above. Recognizing Bluetooth pencils in iPad / iPhone OneNote version

          1 vote
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            Signed in as (Sign out)
            You have left! (?) (thinking…)
            0 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
          • Set transparency of graphic items

            Would be nice to set transparency and other aspects on an image. Especially when doing background items, would be nice to use an image like a watermark. (also convert to gray scale)

            1 vote
            Vote
            Sign in
            Check!
            (thinking…)
            Reset
            or sign in with
            • facebook
            • google
              Password icon
              Signed in as (Sign out)
              You have left! (?) (thinking…)
              0 comments  ·  Flag idea as inappropriate…  ·  Admin →
            • Export Options - what to include/how to include

              Currently you have no real control how OneNote exports. If you want to maintain graphics made part of the page they only show up in PDF export. Colors of pages don't show up in anything. Should be able to selectively accept/reject which things you want o do with how the application exports into different formats.

              1 vote
              Vote
              Sign in
              Check!
              (thinking…)
              Reset
              or sign in with
              • facebook
              • google
                Password icon
                Signed in as (Sign out)
                You have left! (?) (thinking…)
                0 comments  ·  Flag idea as inappropriate…  ·  Admin →
              • OneNote pictures

                When you drap and drop a picture onto a page, their order is determined when they are dropped, with last item being on top. Though you can right click and see an order option it has no affect, nor does the Arrange option on Draw tab.

                Needs to be able to arrange order: send to back, bring to front, forward and back.

                1 vote
                Vote
                Sign in
                Check!
                (thinking…)
                Reset
                or sign in with
                • facebook
                • google
                  Password icon
                  Signed in as (Sign out)
                  You have left! (?) (thinking…)
                  0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                • Specify default notebook

                  GET /notebooks shows us an isDefault parameter per notebook but it's read-only, there's no ability to change this. (indeed there's no PATCH for notebooks at all)

                  Being able to change the default note book would be very useful. I'm sure I'm not on my own by never using the "[My name]'s Notebook" I'd much rather have clippings go to the actual notebook that I use day to day.

                  Until the time when the OneDrive UI or online OneNote UI allows us ot set a default notebook for clipping etc can you at least let us do it programmatically via the…

                  15 votes
                  Vote
                  Sign in
                  Check!
                  (thinking…)
                  Reset
                  or sign in with
                  • facebook
                  • google
                    Password icon
                    Signed in as (Sign out)
                    You have left! (?) (thinking…)
                    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                  • I'd like an API to determine who a notebook or section has been shared with.

                    The existing API lets me know that a notebook IS shared, but as far as I can tell does not have any mechanism for telling my code who has access.

                    7 votes
                    Vote
                    Sign in
                    Check!
                    (thinking…)
                    Reset
                    or sign in with
                    • facebook
                    • google
                      Password icon
                      Signed in as (Sign out)
                      You have left! (?) (thinking…)
                      1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                    • An API should exist to set sharing on a notebook or section

                      This is necessary for a variety of publishing scenarios.

                      11 votes
                      Vote
                      Sign in
                      Check!
                      (thinking…)
                      Reset
                      or sign in with
                      • facebook
                      • google
                        Password icon
                        Signed in as (Sign out)
                        You have left! (?) (thinking…)
                        0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                      • Add a 'GET' page example to the OneNoteAPISampleNodejs

                        It'd be nice if there was an example of retrieving a note using https://github.com/OneNoteDev/OneNoteAPISampleNodejs
                        All of the examples only show how to do a 'POST' to create different types of pages.

                        4 votes
                        Vote
                        Sign in
                        Check!
                        (thinking…)
                        Reset
                        or sign in with
                        • facebook
                        • google
                          Password icon
                          Signed in as (Sign out)
                          You have left! (?) (thinking…)
                          0 comments  ·  Samples  ·  Flag idea as inappropriate…  ·  Admin →
                        • POST with {id} to update an entire page

                          I see this is in the roadmap but hasn't made it to Beta - this would be the POST equivalent of the GET to get a page, replacing it in its entirety.

                          3 votes
                          Vote
                          Sign in
                          Check!
                          (thinking…)
                          Reset
                          or sign in with
                          • facebook
                          • google
                            Password icon
                            Signed in as (Sign out)
                            You have left! (?) (thinking…)
                            2 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                          • decent instruction

                            How about some clear instructions. Not those idiotic videos, but clear written instructins

                            7 votes
                            Vote
                            Sign in
                            Check!
                            (thinking…)
                            Reset
                            or sign in with
                            • facebook
                            • google
                              Password icon
                              Signed in as (Sign out)
                              You have left! (?) (thinking…)
                              2 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                            • Embedded codeboxes

                              Provide support to copy/paste in code snippets into oneNote pages. Maybe even preserve syntax highlighting (atleast from Visual Studios).

                              35 votes
                              Vote
                              Sign in
                              Check!
                              (thinking…)
                              Reset
                              or sign in with
                              • facebook
                              • google
                                Password icon
                                Signed in as (Sign out)
                                You have left! (?) (thinking…)
                                1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                              • [Possibilities / capabilities of the programmer] Möglichkeiten/Fähigkeiten der Programmierer

                                Fragt Euch doch mal warum ein einzelner Programmierer mit Gem für OneNote so viele Funktionen einbauen kann die das ganze Team nicht hinbekommt?

                                Wo habert es?
                                Das es keinen Bedarf an den Funktionen gibt kann eher nicht sein, sonst würde Gem sich nicht verkaufen!

                                2 votes
                                Vote
                                Sign in
                                Check!
                                (thinking…)
                                Reset
                                or sign in with
                                • facebook
                                • google
                                  Password icon
                                  Signed in as (Sign out)
                                  You have left! (?) (thinking…)
                                  0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                                • Create a OneNote "Digest" option in IFTTT

                                  In IFTTT, there are email digest options that allow a day's or week's worth of content to be dumped at a specific time to an email. Allow the same feature in OneNote so that each trigger doesn't create a separate page, but aggregates a day's worth (or a set number) of content on one page.

                                  17 votes
                                  Vote
                                  Sign in
                                  Check!
                                  (thinking…)
                                  Reset
                                  or sign in with
                                  • facebook
                                  • google
                                    Password icon
                                    Signed in as (Sign out)
                                    You have left! (?) (thinking…)
                                    0 comments  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                                  • Code samples for web-app js authentication

                                    Google wraps up their auth api into a real nice JS lib that you can just load: <script type="text/javascript" src="https://apis.google.com/js/api.js?onload=onApiLoad"></script>
                                    <script>

                                    Some usage: http://stackoverflow.com/a/22484429/4142536

                                    I'd love for this to exist for OneNote authentication. It should be dead-simple for me to integrate one-note into my JS web-app.

                                    13 votes
                                    Vote
                                    Sign in
                                    Check!
                                    (thinking…)
                                    Reset
                                    or sign in with
                                    • facebook
                                    • google
                                      Password icon
                                      Signed in as (Sign out)
                                      You have left! (?) (thinking…)
                                      0 comments  ·  Flag idea as inappropriate…  ·  Admin →
                                    • Why don't you provide a API to capture a web page as HTML content but not image ?

                                      The web page screenshot is not very convenient to read, edit and copy. I think you should provide an API which can accept a URL and save the webpage content as HTML format.

                                      33 votes
                                      Vote
                                      Sign in
                                      Check!
                                      (thinking…)
                                      Reset
                                      or sign in with
                                      • facebook
                                      • google
                                        Password icon
                                        Signed in as (Sign out)
                                        You have left! (?) (thinking…)
                                        0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                                      • Keep the github samples up to date

                                        As you add new capabilities, please update your samples on GitHub. I am particularly interested in the windows phone and windows store app samples.

                                        22 votes
                                        Vote
                                        Sign in
                                        Check!
                                        (thinking…)
                                        Reset
                                        or sign in with
                                        • facebook
                                        • google
                                          Password icon
                                          Signed in as (Sign out)
                                          You have left! (?) (thinking…)
                                          2 comments  ·  Samples  ·  Flag idea as inappropriate…  ·  Admin →
                                        • Bug Report : Some images will be lost when I capture a webpage with the API.

                                          Some images will be lost when I capture a webpage with the API . This will undermine our confidence to OneNote API.

                                          3 votes
                                          Vote
                                          Sign in
                                          Check!
                                          (thinking…)
                                          Reset
                                          or sign in with
                                          • facebook
                                          • google
                                            Password icon
                                            Signed in as (Sign out)
                                            You have left! (?) (thinking…)
                                            2 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
                                          • Don't see your idea?

                                          OneNote Developer APIs

                                          Feedback and Knowledge Base