App Connect

 View Only

Using IBM® App Connect to interact with Microsoft OneNote

By Shahmini Arumugam posted Thu September 14, 2023 02:28 AM


Co-author – Srihari Ananda Kumar 

Microsoft OneNote is a digital notebook designed to collect information and organize notes freely, making it a useful tool for organizing ideas and effectively collaborating with people in real time.

OneNote is used to track ideas and notes for home, school, or work by typing, sketching, or speaking from any device.

Building a flow in IBM App Connect with Microsoft OneNote

Use App Connect to build flows that integrate with Microsoft OneNote and other applications. The connector is displayed as Microsoft OneNote on the App Connect User Interface (UI). 

To allow App Connect to connect to your Microsoft OneNote account, you need to complete the connection fields that you see in the App Connect Designer Catalog page or flow editor.

For more information on connection fields, see How to use App Connect with Microsoft OneNote.

Microsoft OneNote objects 

The following are the Microsoft OneNote objects that can be run in App Connect.




Microsoft OneNote is a digital notebook that saves and syncs your notes instantly. You can create content, organize your work, and collaborate with others by creating a notebook in OneNote.

Section groups

Section groups in Microsoft OneNote are groups of sections that are kept separate from the remaining pages of the notebook. You can use section groups to organize sections, which allow you to group multiple related sections together in OneNote.


Microsoft OneNote notebooks consist of sections and pages. Pages contain the actual notes, whereas sections contain collections of related pages. Each notebook can have multiple sections, and any section can have as many pages as required.


Scenario 1: Create a page with embedded content in Microsoft OneNote for the email received with attachments from Microsoft Exchange

Consider this scenario where you use App Connect to create a page with embedded content in Microsoft OneNote for each new email received with attachments from Microsoft Exchange. Otherwise, a Slack notification is sent, notifying that the email has no attachment.

In this flow:

  1. The event-driven flow is triggered whenever a new email is received from Microsoft Exchange.
  2. If the email has attachments, Microsoft Exchange retrieves the attachments from the email message.
    1. For each retrieved attachment, Microsoft Exchange downloads the attachment from the email message. 
    2. The Microsoft OneNote Create page with embedded content operation creates a page in Microsoft OneNote with the downloaded attachment content.

      The attachment content must be specified in HTML format.

      For example:

      Note: You can configure the Content property to include multiple images and file attachments.
      For more information about configuring this property, see General Considerations - How to use IBM App Connect with Microsoft OneNote.

  3. Otherwise, A Slack message gets sent to the intended channel to notify them that the email retrieved is without any attachments.

ResourcesTry out our templates

You can view the following use cases in the Templates gallery in your App Connect Designer instance.

The following use cases are available in the Templates gallery on App Connect Designer.

·         Create a page with embedded content in Microsoft OneNote for the email received with attachments from Microsoft Exchange

       Template URL: https://<your-instance-id>/templates/Create%20a%20page%20with%20embedded%20content%20for%20each%20new%20email%20received%20with%20attachments%20from%20Microsoft%20Exchange 

·         Create an HTML file in Box for each page of the HTML content retrieved from Microsoft OneNote
Template URL:

·         Append a note in Microsoft OneNote when a task is created in Asana
Template URL:

·         Append a note to the Microsoft OneNote page for each file downloaded from Google Drive
Template URL:

You must enable the Designer AI features in your containerized environment to access the App Connect templates. For more information, see The preloaded IBM App Connect templates.

You can also import these use cases directly into your App Connect Designer. These templates are added to a public GitHub repository at

For any inquiries on this blog or connector, contact Srihari at