OneNote Developer APIs

Update: Microsoft will be moving away from UserVoice sites on a product-by-product basis throughout the 2021 calendar year. We will leverage 1st party solutions for customer feedback. Learn more

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. Classroom Notebook backs up the teacher and alllllll of the student content. Taking up major space on teacher's hard drive. The teachers c

    Classroom Notebook backs up the teacher and alllllll of the student content. Taking up major space on teacher's hard drive. The teachers content only needs to be backed up and the students has their own backup. This has to be addresses - Soon, please!!

    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

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

    We're glad you're here

    Please sign in to leave feedback

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

      &lt;title&gt;some title generated&lt;/title&gt;
    
    &lt;meta name=&quot;created&quot; content=&quot;some time string generated&quot; /&gt;

    </head>
    <body>

      &lt;div data-id=&quot;_clippings&quot;&gt;&lt;/div&gt;
    

    </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>

      &lt;title&gt;test without content&lt;/title&gt;
    
    &lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html; charset=utf-8&quot; /&gt;
    &lt;meta name=&quot;created&quot;
    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  4. Ability to copy sections between different users' Notebooks in Office 365

    I'm trying to copy section of a notebook, or even notebook itself, from a notebook in one user's OneDrive to another user's notebook in their OneDrive. The user I'm logged in as has permissions to read and write both notebooks. I'm getting the error response:

    message=The specified resource ID does not exist.
    @api.url=http://aka.ms/onenote-errors#C20102
    code=20102
    Where the path I'm using is of the form https://www.onenote.com/api/v1.0/users/{id}/notes/sections/{id}/copyToNotebook where the ids in that are for the source section.

    which is presumably because the id in the post request represents a notebook under a different user.

    If I was copying to a SharePoint site…

    3 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  5. Full OCR Data

    The OCR data in OneNote has both a token and text data:

    <one:OCRText><![CDATA[CHAPTER 32 ]]></one:OCRText>
    <one:OCRToken startPos="0" x="132.75" y="76.5" width="207" height="27" />

    Please make this available via JSON for add-ins and in the API. For example:

    {[

     {
    
    &quot;text&quot;:&quot;something&quot;,
    &quot;position&quot;:{
    &quot;x&quot;: 132
    &quot;y&quot;: 40
    &quot;width&quot;: 150
    &quot;height&quot;: 200
    }
    },
    //Rest of OCR text associated with an image

    ]}

    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  6. Allow setting a background image on a page

    The inbuilt templates have an image embedded into the page. I'd like to do this programatically please.

    the body node only allows background colour, settings an image that is the background relative to top left of the page would be great,
    Also mentioned here:

    https://onenote.uservoice.com/forums/327186-onenote-for-windows-windows-phone/suggestions/6164483-lock-an-image-as-a-background

    7 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  7. Create a New Page with a Certain Indent Level

    We should be able to create a page and have that page be indented at a certain level upon creation.

    Right now if we want to do that, we have to first create the page, then keep trying to patch indent to it periodically until OneNote actually does make the page and allows a patch. It'd be nice to unify the two calls (which requires a loop right now since patch always fails 404 for about a minute or so due to creation sync delays with OneNote)

    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  8. Ability to set Rule Lines via API

    It would be useful to be able to set rule lines via the API. We've got a customer who would like it as we create NoteBooks across the school.

    6 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    2 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  9. API to retrieve links to other OneNote pages in page content

    In OneNote, pages can contain links to other pages (as well as to websites, other OneNote sections/notebooks, network shares ...).I needed a way programmatically to GET the content of such pages and had to code my own link retrieval routine. It'd be good if the API could do this for me ;)
    See my exchange with Jorge Aguirre about this request:
    http://stackoverflow.com/questions/36207073/any-way-in-onenote-api-to-extract-link-to-another-onenote-page

    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  10. Ability to upload and download notebooks via rest API

    Given the 5000 SharePoint/Office365 item limit, it would be extremely useful to be able to move notebooks in and out of sharepoint without resorting to convoluted onedrive/curl hacks.

    6 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  11. API to retrieve an HTML preview of a page

    Simple - GET pages/id/preview, which returns pretty HTML with a preview of the page to use in my picker scenario.

    3 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  12. PUT Pages {id} to overwrite page contents

    Even though it is possible to modify Page contents with the API, it's unnecessarily cumbersome to overwrite the whole thing.

    PUT Pages {id} would simplify the process immensely, enriching overall API.

    8 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  13. Rest API - ability to change the order of pages programmatically

    Rest API - ability to change the order of pages programmatically

    11 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  14. Get full text OCR from images

    Say I use the API to search for information and want to show a snippet around the search term. If I could get all the text via the /content endpoint of a page I could achieve this.

    Idea from Mikael Svenson

    4 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  15. Integration with various smartpens

    Increase integration with popular smartpen products, such as Equil, LiveScribe, and the new Neo 2 Smartpen. Should include the ability to transfer the vector graphics and integration of synchronized audio with notes.

    22 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  16. REST API to create hyperlinks to objects on a page

    A REST method like GetHyperLinkToObject Method in the OneNote client API would be very handy to create multiple pages with links between them. Since page objects can already be retrieved with an id, the REST method to generate an hyperlink would take that id and turn it into a hyperlink which can be used to navigate to that object on the page

    3 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    1 comment  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  17. Developer Token for immediate access to own notebooks

    Evernote provides a special "Developer Token" for developers to manipulate items in the own accounts. The token is passed in the header or as part of the REST URL and does not require a refresh token. It would be nice to have a similar feature in the OneNote API to be able to access/modify information in my own notebooks as most of my development is for my own use.

    7 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  18. calculator

    it would be great to have a calculator that will log all calculations then allow notes to be added. this would be great to work out costs and bills with the sync feature and being able to share notes this would be very convenient in many work places i know and to work out yearly bills etc.

    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  19. Be able to put several clips into one note.

    Right now you can clip a page or section of page and it drops into OneNote, but have an option where you can keep clipping multiple clips (for example researching a subject) and then once you have many clips on the clipper, go ahead and drop them all onto one new page instead of having to have each clip be a page on its own.

    1 vote
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  20. Add ModifiedBy to page objects

    Right now when a user changes a page, the containing Section has a ModifiedBy field which is updated. However, the Page itself has no such field. This makes it impossible for a change polling service to distinguish who changed individual pages between polls, and makes it cumbersome to get any such information at all (via the Section).

    3 votes
    Vote

    We're glad you're here

    Please sign in to leave feedback

    Signed in as (Sign out)
    You have left! (?) (thinking…)
    0 comments  ·  REST API  ·  Flag idea as inappropriate…  ·  Admin →
  • Don't see your idea?

OneNote Developer APIs

Categories

Feedback and Knowledge Base