OneNote (Business)

OneNote (Business)

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.

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
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

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.

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.

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 10 seconds

Actions

Create a page in Quick Notes

Create a new page in the Quick Notes section.

Required Parameters

Page Content
string
Page content in HTML.

Returns

Body
Page

Create page in a section

Create new page in a specified section.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.
Notebook section
string
API URL of the section pages.
Page Content
string
Page content in HTML.

Returns

Body
Page

Create section in a notebook

Create section in a notebook.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.

Optional Parameters

Name of the new section
string
The name of the new section.

Returns

Get notebooks

Get available notebooks.

Required Parameters

Page Content
string
Page content in HTML.

Returns

array of Notebook

Get page content

Get HTML page content.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.
Notebook section
string
API URL of the section pages.
Page Id
string
Unique id of the page.

Returns

Body
Page

Get pages for a specific section

Get pages for a specific section.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.
Notebook section
string
API URL of the section pages.

Returns

Get sections in notebook

Get sections in a specific notebook.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.

Returns

value
array of SectionListItem
Get sections in a specific notebook.

Triggers

When a new page is created in a section

Triggers a flow when a new page is added to a section.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.
Notebook section
string
API URL of the section pages.

Returns

Body
NewPageResponse

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.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.

Returns

Body
NewSectionGroupResponse

Response for a new section group.

When a new section is created

Triggers a flow when a new section is added to a notebook.

Required Parameters

Notebook Key
string
A key identifying the notebook. Note this is specific to the API and cannot be hand-typed.

Returns

Body
NewSectionResponse

Response for a new section.

Definitions

CreateSectionInNotebookResponse

Create section in notebook object id
string
Created by name
string
This section created by name.
Created time
date-time
This section created time.
Default section flag
boolean
A flag to indication if this is the default section.
Desktop client href
string
OneNote desktop client href.
Last Modified By
string
Last modified by name.
Last Modified Time
date-time
The time this section was last modified.
OData context
string
The OData context.
Section Name
string
The name of the section.
The pages Url
string
The url of the pages.
Url to create section in notebook
string
The url to create section in notebook group.
Web client href
string
OneNote web client href.

Page

Content Url
string
A url to the page content.
Created Date
date-time
The date the page was created.
Id
string
The unique identifier of the page.
Last Modified Date
date-time
The last modified date of the page.
Page title
string
The title of the page.
links
Link
The links associated with the OneNote page.

Notebook

FileName
string
Key
string

ParentNotebook

Parent Notebook Key
string
The unique identifier of the parent notebook.
Parent Notebook Name
string
The name of the parent notebook.
Parent Notebook Url
string
A url link to the parent notebook.

The links associated with the OneNote page.

oneNoteClientUrl
OneNoteClientUrl
The links associated with the OneNote page.
oneNoteWebUrl
OneNoteWebUrl
The links associated with the OneNote page.

OneNoteClientUrl

OneNote client url
string
A link to the notebook using the OneNote windows client.

OneNoteWebUrl

OneNote web url
string
A link to the notebook using the OneNote web client.

SectionListItem

The fields included in a section list item.

Section Identifier
string
Unique identifier of the section.
Section key
string
The key used to reference this section; also a url to the pages.
Section name
string
The name of the section.

SectionResponse

The fields included in a section.

Creation Date
date-time
The creation date and time of the section.
Creator
string
The creator of the section.
Last Modified By
string
The user who last modified the section.
Last Modified Date
date-time
The last modified date and time of the section.
Pages Url
string
Url to the pages in this section.
Section Identifier
string
Unique identifier of the section.
Section Name
string
The name of the section.
Url
string
The url to this section.
parentNotebook
ParentNotebook
The fields included in a section.

SectionGroupResponse

The fields included in a section group.

Creation date
date-time
The creation date and time of the section group.
Creator
string
The creator of the section group.
Identifier
string
Unique identifier of the section group.
Last modified date
date-time
The last modification date and time of the section group.
Last modifier
string
The user who last modified the section group.
Name
string
The name of the section group.
Section Group Url
string
The url to this section group.
Sections Url
string
Url of the sections within this section group.

NewSectionResponse

Response for a new section.

Sections
array of SectionResponse
An array of objects, each representing a specific section.

NewSectionGroupResponse

Response for a new section group.

Section Groups
array of SectionGroupResponse
An array of objects, each representing a specific section group.

NewPageResponse

Response for a new page.

Pages
array of Page
An array of objects, each representing a specific page.

GetPagesInSectionResponse

Content Url
string
The content url.
Created by app id
string
The created by app id.
Created time
date-time
The created time for this response.
Last modified time
date-time
The last modified time for this object.
OData context
string
The OData context.
OneNote desktop client href
string
OneNote desktop client href.
OneNote web client href
string
OneNote web client href.
Page title
string
Page title.
Pages In Section group
string
The url to the Pages In Section group.
Pages in Section parent section
string
The url to the pages in section parent section.
Pages in section value object
array of object
value
Parent Section OData context
string
Parent Section OData context.
Parent section name
string
Parent section unique identifier
string
The unique identifier for this object parent section.
Unique identifier for response
string
The unique identifier for this response.