-->
![Onenote Onenote](/uploads/1/3/4/2/134258608/801129333.jpg)
- Onenote 2016 Default Notebook Location
- Onenote Default Notebook Location
- Onenote Show Notebooks On Left
- Onenote Default Notebook Location
OneNote is a note taking app from Microsoft that makes it easy to sync your ideas, sketches and notes across all your devices! Connect to your Office 365 account with OneDrive for Business enabled to track new sections, create notes and more.
When you first start using OneNote for Windows 10, it opens the default notebook for the account that you’ve signed in with. You can begin using this notebook, you can create new notebooks, or you can open additional notebooks from any of your Microsoft accounts (for example, Hotmail, Live.com, or Outlook.com) — or from your work or school accounts. The default notebook is the notebook where new notes, web clips from Evernote Web Clipper, and saved emails are all automatically saved if no other notebook is specified. Change your default notebook To change your default notebook, follow the steps for your operating system below.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions |
Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet |
Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet |
Connector Metadata | |
---|---|
Publisher | Microsoft |
Website | https://products.office.com/onenote/digital-note-taking-app |
To use this integration, you will need access to a OneNote notebook stored on OneDrive For Business. To make a connection, select Sign In. You will be prompted to provide your O365 account wih OneDrive for Business enabled, follow the remainder of the screens to create a connection.
Known Issues and Limitations
When using the connection, if you're not seeing the list of notebook you're expecting please check the account you created the connection with and try again. If you see an error while using the connector you may look up the error code for more information.
Note that this integration requires connecting with an account that has the 'UserRemoteAPIs' permission. If you see this error: 'Error: the user doesn't have permissions to access the requested resource', the account may not have the correct permissions. A SharePoint administrator can control permission levels by browsing to the site collection and opening the Site settings. Select the Site Permissions and then the Permission Level to see the permissions (such as the Use Remote Interfaces) the level contains. If a user belonging to a certain level doesn't not have the required permission, either modify the level by checking the box for the permission or create a new permission level and assign that to the user.
The connector currently does not support an explicit input parameter Page Title for the Create Page actions. This is a limitation arising from the OneNote API implementation. However, the title can be specified as a part of the Page Content in HTML by using the tags.
Notebook section.If you want to provide a custom value for the Notebook Section parameter, please specify it in the API URL format. The api url pattern:
https://www.onenote.com/api/v1.0/myOrganization/siteCollections/{siteCollectionsId}/sites/{SiteId}/notes/sections/{SectionId}/pages
For more information, you can take a look at OneNote API documentation.Note
The following characters are not allowed in the notebook name: *':<>?/|%
You're now ready to start using this integration.
Throttling Limits
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 100 | 60 seconds |
Frequency of trigger polls | 1 | 1200 seconds |
Actions
Create a page in Quick Notes | Create a new page in the Quick Notes section. |
Create page in a section | Create new page in a specified section. |
Create section in a notebook | Create section in a notebook. |
Delete a page (Preview) | Delete a page. |
Get page content | Get HTML page content. |
Get pages for a specific section | Get pages for a specific section. |
Get recent notebooks | Get recent notebooks. |
Get sections in notebook | Get sections in a specific notebook. |
Update page content (Preview) | Update HTML page content. |
Create a page in Quick Notes
Create a new page in the Quick Notes section.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
pageContent | True | html | Page content. |
Returns
- Body
- Page
Create page in a section
Create new page in a specified section.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Notebook section | sectionId | True | string | API URL of the section pages. |
pageContent | True | html | Page content. |
Returns
- Body
- Page
Create section in a notebook
Create section in a notebook.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Name of the new section | name | string | The name of the new section. |
Returns
Delete a page (Preview)
Delete a page.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Notebook section | sectionId | True | string | API URL of the section pages. |
pageId | True | string | Unique id of the page. |
Get page content
Get HTML page content.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Notebook section | sectionId | True | string | API URL of the section pages. |
pageId | True | string | Unique id of the page. |
Returns
- response
- string
Get pages for a specific section
Get pages for a specific section.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Notebook section | sectionId | True | string | API URL of the section pages. |
Returns
Get recent notebooks
Get recent notebooks.
Returns
Get sections in notebook
Get sections in a specific notebook.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. |
Returns
Name | Path | Type | Description |
---|---|---|---|
value | value | array of SectionListItem |
Update page content (Preview)
Update HTML page content.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Notebook section | sectionId | True | string | API URL of the section pages. |
pageId | True | string | Unique id of the page. | |
Target | target | string | The element to update. | |
action | string | The action to perform on the target element. | ||
Location | position | string | The location to add the supplied content. | |
content | html | The new content. |
Returns
- response
- string
Triggers
When a new page is created in a section | Triggers a flow when a new page is added to a section. |
When a new section group is created | Triggers a flow when a new section group is added to a notebook. |
When a new section is created | Triggers a flow when a new section is added to a notebook. |
When a new page is created in a section
Triggers a flow when a new page is added to a section.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. | |
Notebook section | sectionId | True | string | API URL of the section pages. |
Returns
Response for a new page.
When a new section group is created
Triggers a flow when a new section group is added to a notebook.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. |
Returns
Response for a new section group.
- Body
- NewSectionGroupResponse
When a new section is created
Triggers a flow when a new section is added to a notebook.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
notebookKey | True | string | A key identifying the notebook. Note this is specific to the API and cannot be hand-typed. |
Returns
Response for a new section.
- Body
- NewSectionResponse
Definitions
CreateSectionInNotebookResponse
Name | Path | Type | Description |
---|---|---|---|
@odata.context | string | The OData context. | |
Created by name | createdBy | string | This section created by name. |
createdTime | date-time | This section created time. | |
Create section in notebook object id | id | string | |
isDefault | boolean | A flag to indication if this is the default section. | |
Last Modified By | lastModifiedBy | string | Last modified by name. |
lastModifiedTime | date-time | The time this section was last modified. | |
Desktop client href | links.oneNoteClientUrl.href | string | OneNote desktop client href. |
links.oneNoteWebUrl.href | string | OneNote web client href. | |
Section Name | name | string | The name of the section. |
pagesUrl | string | The url of the pages. | |
Url to create section in notebook | self | string | The url to create section in notebook group. |
![Onenote Onenote](/uploads/1/3/4/2/134258608/801129333.jpg)
Page
Name | Path | Type | Description |
---|---|---|---|
title | string | The title of the page. | |
links | links | Link | The links associated with the OneNote page. |
contentUrl | string | A url to the page content. | |
Last Modified Date | lastModifiedTime | date-time | The last modified date of the page. |
createdTime | date-time | The date the page was created. | |
Id | id | string | The unique identifier of the page. |
Notebook
Name | Path | Type | Description |
---|---|---|---|
FileName | string | ||
Key | Key | string |
ParentNotebook
Name | Path | Type | Description |
---|---|---|---|
id | string | The unique identifier of the parent notebook. | |
Parent Notebook Name | name | string | The name of the parent notebook. |
self | string | A url link to the parent notebook. |
Link
The links associated with the OneNote page.
Name | Path | Type | Description |
---|---|---|---|
oneNoteClientUrl | OneNoteClientUrl | ||
oneNoteWebUrl | oneNoteWebUrl | OneNoteWebUrl |
OneNoteClientUrl
Name | Path | Type | Description |
---|---|---|---|
href | string | A link to the notebook using the OneNote windows client. |
OneNoteWebUrl
Name | Path | Type | Description |
---|---|---|---|
href | string | A link to the notebook using the OneNote web client. |
SectionListItem
The fields included in a section list item.
Name | Path | Type | Description |
---|---|---|---|
name | string | The name of the section. | |
Section key | pagesUrl | string | The key used to reference this section; also a url to the pages. |
id | string | Unique identifier of the section. |
SectionResponse
The fields included in a section.
Name | Path | Type | Description |
---|---|---|---|
createdBy | string | The creator of the section. | |
Creation Date | createdTime | date-time | The creation date and time of the section. |
id | string | Unique identifier of the section. | |
Last Modified By | lastModifiedBy | string | The user who last modified the section. |
lastModifiedTime | date-time | The last modified date and time of the section. | |
Section Name | name | string | The name of the section. |
pagesUrl | string | Url to the pages in this section. | |
parentNotebook | parentNotebook | ParentNotebook | |
self | string | The url to this section. |
SectionGroupResponse
The fields included in a section group.
Name | Path | Type | Description |
---|---|---|---|
createdTime | date-time | The creation date and time of the section group. | |
Creator | createdBy | string | The creator of the section group. |
id | string | Unique identifier of the section group. | |
Last modifier | lastModifiedBy | string | The user who last modified the section group. |
lastModifiedTime | date-time | The last modification date and time of the section group. | |
Name | name | string | The name of the section group. |
sectionsUrl | string | Url of the sections within this section group. | |
Section Group Url | self | string | The url to this section group. |
NewSectionResponse
Response for a new section.
Name | Path | Type | Description |
---|---|---|---|
value | array of SectionResponse | An array of objects, each representing a specific section. |
NewSectionGroupResponse
Response for a new section group.
Name | Path | Type | Description |
---|---|---|---|
value | array of SectionGroupResponse | An array of objects, each representing a specific section group. |
NewPageResponse
Cyberpunk steam. Response for a new page.
Name | Path | Type | Description |
---|---|---|---|
value | array of Page | An array of objects, each representing a specific page. |
GetPagesInSectionResponse
Name | Path | Type | Description |
---|---|---|---|
@odata.context | string | The OData context. | |
Pages in section value object | value | array of object | value |
value.contentUrl | string | The content url. | |
Created by app id | value.createdByAppId | string | The created by app id. |
value.createdTime | date-time | The created time for this response. | |
Unique identifier for response | value.id | string | The unique identifier for this response. |
value.lastModifiedTime | date-time | The last modified time for this object. | |
OneNote desktop client href | value.links.oneNoteClientUrl.href | string | OneNote desktop client href. |
value.links.oneNoteWebUrl.href | string | OneNote web client href. | |
Parent section unique identifier | value.parentSection.id | string | The unique identifier for this object parent section. |
value.parentSection.name | string | ||
Pages in Section parent section | value.parentSection.self | string | The url to the pages in section parent section. |
[email protected] | string | Parent Section OData context. | |
Pages In Section group | value.self | string | The url to the Pages In Section group. |
value.title | string | Page title. |
string
This is the basic data type 'string'.
To get the most power out of OneNote you want to be able to synchronise the contents of your notebooks between devices and possibly share them with other people.
Cloud based save, sync or sharing is a standard requirement for most software these days and OneNote is no exception by offering such a feature.
However, due to the smart way that OneNote handles synchronisation and coupled with the fact that it’s generally called OneDrive sync – OneDrive of course being Microsoft’s cloud storage platform – confusion can ensue when people start to migrate to using OneDrive for notebook sync.
What they tend to do is copy their notebooks from wherever they used to store them and then paste them into their OneDrive folder. This seems pretty sensible because it’s called OneDrive sync, so we just put the files into OneDrive, right?
Logical, yes. Correct, no.
Another common confusion is that within OneNote a user might create a new notebook ‘on OneDrive’ – this is the default option when creating new notebooks with OneNote – but when they come to browse their OneDrive folder to find the notebook, say they want to back it up or make a copy, they can’t find it.
Right here is the point where it can get slightly confusing and this is what I’d like to address with this article.
To be clear, the two confusions are:
- a notebook that is demonstrably ‘on OneDrive’ remains invisible when access is attempted using the OneNote app
- a notebook that was created by OneNote to be stored on your OneDrive cannot be found, instead there’s a strange file that’s only 1KB is size and it most definitely is not a OneNote notebook
Why is this?
There is a lot of magic going on behind the scenes when OneNote & OneDrive are syncing your changes between machines.
Normally, cloud sync services like OneDrive or Dropbox copy the newest version of the file up to the cloud and then send it out to all the other devices logged in to that account.
When OneNote does its native ‘OneDrive sync’ it actually only sends the changes up to the cloud which subsequently then sends these changes out to the other devices.
The important thing is that you have a full copy of the notebook on your local machine and it’s only the changes that are being synced.
That is to say the file isn’t actually on OneDrive as a file that you can open. You have the notebook stored on your machine (tucked away somewhere) and it just happens that it’s on the OneDrive servers where this special OneNote-only synchronisation occurs, hence the confusion.
The placeholder that sits within your OneDrive with the same name as the notebook is just a shortcut to the web-only OneNote view. If you open the file with a text editor you can see the contents:
Ok, so what does this all mean?
If you want to share your notebook between devices and/or other people then you need to use the OneNote program itself to plumb in the syncing. It needs to create or move the notebook and then tell OneDrive that you’re now using OneNote syncing, hiding the notebook and then leaving that shortcut placeholder.
What I actually want is a physical copy of my notebook so I can back it up
You can get that and still use OneDrive syncing. Under Options > Save & Backup you can tell OneNote to automatically place backups in a location that you dictate on schedule between once a minute and once every 6 weeks. Confusingly you could even set that backup folder to be on OneDrive where it would then sync the actual .one OneNote file(s) between your machines as you would expect.
But I really don’t want to use OneDrive
Firstly it’s worth noting that to use OneNote syncing to OneDrive you don’t need to install the OneDrive cloud sync software; it’s all built into OneNote.
But that said, if you really want to lose the ability to sync your notebook to mobile devices or if you are prepared to get sync conflicts when you share the notebook old-school using your cloud sync platform, then this is still an option for you.*
When creating a new notebook simply don’t select OneDrive as the location, choose This PC and select where you’d like to store the physical file.
If, however, you are already syncing your notebook via OneDrive then just use the export command. Export the page, section or entire notebook into the OneNote native format and you can put it wherever you want. OneNote will still be able to open it. You just cannot share it very easily (or effectively).
* this is not currently an option for iOS, Android or OSX versions of OneNote, your only option is to use OneDrive syncing.
I definitely want to start syncing using OneDrive so I can get my notebooks on all devices, how do I make it work?
Onenote 2016 Default Notebook Location
Assuming you have a .one or .onepkg file created by OneNote you just open it normally; you don’t copy the notebook to OneDrive first.
Then go to File > Share. Select (or login) to your OneDrive and press Move Notebook.
All the magic now happens and you should eventually see the shortcut file in your OneDrive folder.
If you open the OneNote program on your phone or other device, that notebook should now be in the list of notebooks that you have available to open.
Summary
A lot of magic happens under the hood with OneNote syncing. To get it working you simply need to use the OneDrive syncing options within OneNote itself.
Onenote Default Notebook Location
If you’d like to delve slightly deeper into how that syncing magic works then check out this blog post by Omar Atay, who works on the OneNote team and is the developer of Onetastic a very popular OneNote add-in.
Onenote Show Notebooks On Left
More like this?
If you found this useful then you might like my OneNote blog as it covers similar topics.
Onenote Default Notebook Location
Also, if you’re looking to super-charge your OneNote productivity then I have a book in the works that will help you Get Stuff Done with OneNote.