Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
Access to the Azure Portal with permissions to register applications is required.


​
Register Your Application in Microsoft Entra ID
To connect Microsoft OneNote with StackOne, you need to register an application in Microsoft Entra ID to obtain OAuth 2.0 credentials.
1
Sign in to Microsoft Entra Admin Center
Sign in to the Microsoft Entra admin center as at least an Application Developer. If you have access to multiple tenants, click the Settings (gear) icon in the top-right corner, then select the desired tenant from the list under Directory + subscription.
2
Create a New App Registration
Navigate to Entra ID > App registrations and select New registration.
  • Enter a meaningful Name for your app (e.g., StackOne OneNote Integration).
  • Under Supported account types, select Single tenant if only your organization will use this integration, or Multitenant if you need to support users from multiple Azure AD tenants.
  • Leave the Redirect URI blank for now — you’ll configure it in the next section.
  • Click Register to create the app registration.
3
Copy the Client ID
On the Overview page, copy the Application (client) ID and store it securely for use later.


​
Configure Redirect URI
Add the redirect URI to allow OAuth authentication flow.
1
Navigate to Authentication Settings
From your app’s Overview page, select Authentication (Preview) from the left menu under Manage. If you are using the older UI, this may appear as Authentication.
2
Set the Redirect URI
Under Redirect URI configuration, click Add Redirect URI, select Web, enter the StackOne OAuth callback URL, and click Configure.
  • Redirect URI: https://api.stackone.com/connect/oauth2/onenote/callback
  • Note: If you are using the older UI, under Platform configurations click Add a platform, select Web, enter the URI above, and click Configure.


​
Configure API Permissions
Grant your application the necessary permissions to access OneNote data.
1
Open API Permissions
From the left menu under Manage, select API permissions.
2
Add Microsoft Graph Permissions
Enables actions: Copy Notebook, Copy Page To Section, Copy Section To Notebook, Copy Section To Section Group, Create Notebook, Create Page, Create Section, Create Section In Group, Create User Notebook, Create User Page, Delete Page, Get Notebook, Get Operation Status, Get Page, Get Page Content, Get Page Preview, Get Page Resource, Get Recent Notebooks, Get Section, Get Section Group, Get User, Get User Notebook, Get User Section, List All Pages, List All Section Groups, List All Sections, List Nested Section Groups, List Notebook Section Groups, List Notebook Sections, List Notebooks, List Section Group Sections, List Section Pages, List User Notebooks, List User Pages, List User Section Groups, List User Sections, List Users
Click Add a permission, then select Microsoft Graph. Select Delegated permissions and add the scopes required for your use case, then click Add permissions to save.
3
Grant Admin Consent
Click Grant admin consent for [Your Organization] to authorize these permissions for use across your tenant.


​
Generate Client Secret
Create a client secret that will be used to authenticate your application with Microsoft OneNote.
1
Navigate to Certificates & Secrets
From the left menu under Manage, select Certificates & secrets.
2
Create a New Client Secret
Under the Client secrets tab, click New client secret.
  • Add a Description (e.g., StackOne Integration Secret).
  • Select an expiration period.
  • Click Add.
3
Copy the Client Secret Value
Immediately copy the Value of the newly created client secret and store it securely for use later. This value will only be shown once and cannot be retrieved again.


​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for OneNote:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • Click + Connector Profile
  • Search for and select OneNote
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for OneNote.