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.

    80 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 →
    • Can you make a function so the highlighterpen can only draw straight

      Can you make a function so the highlighterpen can only draw straight

      5 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 →
      • 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!

        1,535 votes
        Vote
        Sign in
        Check!
        (thinking…)
        Reset
        or sign in with
        • facebook
        • google
          Password icon
          Signed in as (Sign out)
          You have left! (?) (thinking…)
          19 comments  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
        • 3,416 votes
          Vote
          Sign in
          Check!
          (thinking…)
          Reset
          or sign in with
          • facebook
          • google
            Password icon
            Signed in as (Sign out)
            You have left! (?) (thinking…)
            173 comments  ·  Flag idea as inappropriate…  ·  Admin →

            Hi there,
            We would like to get more feedback on which of the two scenarios are more important to you:
            1. The ability to create new pages in OneNote from markdown? OR
            2. The ability to recall OneNote pages as markdown?

          • Notebook and pages 'read only' by creator

            Would be great if there was functionality to make notebooks or pages read only by the creator of the notebook or page. We use OneNote at our work for team huddle and huddle notes. Managers would like to have it as read only to prevent their colleagues from changing the huddle notes or attendees.

            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 →
            • tags

              Put Tag Summary for OneNote app - since you are stopping OneNote 2016 Please!! And where is the search for Tags?

              14 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 →
              • Export sections to hard drive

                One note 2016 allowed the sections to rest in folders on a hard drive or in our case our NAS. The new onenote only lives in the cloud, So instead of having a onenote for a project, that rests with all the other files for that project in it folder on a harddrive, now all sections must live in the cloud? In two years and 200 plus projects, how would you even archive old projects if they can not be exported to a hard disk? Bring back the abilty to open and close individual onenote files from a hard disk.

                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  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                • superscript and subscript don't work frustrating for an app to be used for learning and science

                  superscript and subscript don't work frustrating for an app used for science education

                  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 →
                  • A simple way to Code Syntax HIghlight...No extension required !

                    I was searching for any extension that can help me format my code on my OneNote Mac, but I failed. Now finally I discovered a way to do it.
                    If you want to paste a code from any source into your onenote with all the syntax and formatting highlight intact, heres a simple solution.
                    Here's the trick:

                    Visit the stack overflow site and in the reply section, paste your code in the CODE block, after this stackoverflow will show you the preview of your code in Syntax highlighted manner.
                    Now just code from the preview and paste in OneNote.....DONE !! …

                    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…)
                      1 comment  ·  Flag idea as inappropriate…  ·  Admin →
                    • Developer API? What developer API? There's not a developer API. There is a **** poor excuse for a com interface and NOTHING ELSE.

                      I looked on the office site and it basically said there was none. That education plugin was such a tease. It made it seem like things would be forthcoming but there's not one. Visual Studio won't let you create add ONs. there are no add ONs. THe app suggests there should be, but they aren't supported.

                      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  ·  Documentation  ·  Flag idea as inappropriate…  ·  Admin →
                      • Support Word-style content controls and Custom XML Parts

                        We have successfully extended Microsoft Word to handle semantic scientific information: https://www.chem4word.co.uk/ . This free add-in brings rich chemistry to word, and has seen over 200,000 downloads and is used in teaching situations worldwide.

                        We'd like to bring this to OneNote. If OneNote could support Word-style content controls and custom XML parts, then this would open up a whole new world of extensibility and add-ins that would add real value to educators. It would also make OneNote into an unbeatable lab notebook.

                        8 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 →
                        • 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
                          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 →
                          • page of OneNote for Mac

                            OneNote for Mac, page width is too narrow. Please develop new version, so we can expand the page width as wide as we want. I have many pages, I often need to check some information. I set long words in pages, now the page is too narrow, I only can see part of it.

                            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  ·  Others  ·  Flag idea as inappropriate…  ·  Admin →
                            • drag and drop from outlook

                              Please please bring back the drag and drop from outlook feature. I used that feature all the time and frustrated that I have to save to folder from outlook, just extra steps that I don't have time for. Why do upgrades try to fix things that work well.

                              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  ·  Flag idea as inappropriate…  ·  Admin →
                              • Embed Mentimeter

                                Mentimeter is a very powerful interaction tool for classroom activities and it would add great value to interactive and engaging lessons.

                                you can easily embed a Poll or quizzes by just pasting the link would be perfect

                                12 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 →
                                • add a new level

                                  1. I am neither developer nor programmer.
                                  2. Yes, I too would like another level.
                                  BUT, I think if I read 100 pages to understand ??
                                  I have that ability by locating or re-locating that set of note's into a different "Folder" (ie; money, friend, to-do, etc.) on the hard-drive. (YES ??)

                                  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 →
                                  • Insert Functions in Windows 10 App

                                    In the Windows 10 App, all the critical functions I need are missing. Cannot insert Office files, screen clippings or even date and time. This forces me to only use the desktop app with Office 2016.

                                    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  ·  Flag idea as inappropriate…  ·  Admin →
                                    • 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
                                      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 →
                                      • 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
                                        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 →
                                        • Auto-check attendees for skype for business meetings

                                          OneNote 2016 used to automatically take attendance as attendees joined a Skype for Business meeting. I relied on this feature daily and it really helped me to optimize my meeting notes. Please put this back on the new OneNote!!!

                                          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 →
                                          ← Previous 1 3 4 5 13 14
                                          • Don't see your idea?

                                          OneNote Developer APIs

                                          Feedback and Knowledge Base