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
You must have at least Application Developer permissions in your Microsoft Entra ID account to register applications.

Register Your Application in Microsoft Entra ID

To connect Microsoft Outlook 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 or Azure Application 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 App registrations by searching from the top search bar and click on New registration.

  • Enter a meaningful Name for your app (e.g., StackOne Microsoft Outlook 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 Application (Client) ID

After registration, you’ll be directed to the application’s Overview page. Copy the Application (client) ID value and store it securely for use later.

Configure Redirect URI

Set up the OAuth 2.0 callback URL to enable authentication flow between StackOne and Microsoft Outlook.

1

Navigate to Authentication Settings

From your app’s Overview page, select Authentication (Preview) from the left menu under Manage.

2

Navigate to Redirect URI Configuration tab

Click Add a Platform or Add Redirect URI button, then select Web.

3

Set the Redirect URI

In the Redirect URIs field, enter the StackOne OAuth callback URL and click Configure.

  • Redirect URI: https://api.stackone.com/connect/oauth2/microsoftoutlook/callback

Configure API Permissions

Grant your application the necessary Microsoft Graph API permissions to access Microsoft Outlook mail data.

1

Open API Permissions

From the left menu under Manage, select API permissions.

2

Add Microsoft Graph Permissions

Enables actions: Add Attachment, Copy Mail Folder, Copy Message, Create Child Folder, Create Draft Message, Create Draft Reply All To Message, Create Draft Reply To Message, Create Draft To Forward Message, Create Mail Folder, Create Message In Mail Folder, Create Message Rule, Delete Attachment, Delete Mail Folder, Delete Message, Delete Message Rule, Forward Message, Get Attachment, Get Mail Folder, Get Mail Folder Delta, Get Message, Get Message Delta From Folder, Get Message Rule, List Attachments, List Child Folders, List Folder Messages, List Mail Folders, List Message Rules, List Messages, Move Mail Folder, Move Message, Permanently Delete Mail Folder, Permanently Delete Message, Reply All To Message, Reply To Message, Send Draft Message, Send Mail, Update Mail Folder, Update Message, Update Message Rule

Click Add a permission, then select Microsoft Graph.

  • Select Delegated permissions to view the list of permissions.
  • Expand the Mail section and add permissions based on your integration needs.
  • For read-only access: Mail.Read or Mail.ReadBasic
  • For full mail access: Mail.ReadWrite
  • For sending mail: Mail.Send
  • For mailbox settings: MailboxSettings.Read or MailboxSettings.ReadWrite
  • Click Add permissions to save.
3

Grant Admin Consent

Click Grant admin consent for [Your Organization] and select Yes to consent on behalf of all users in your tenant. After granting, verify that Granted for [Your Organization] appears under the Status column for each permission.

Generate Client Secret

Create a client secret that will be used to authenticate your application with Microsoft Outlook.

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 Outlook Integration Secret).
  • Select an appropriate expiration period based on your security requirements.
  • 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.

  • ⚠️ Important: This value will only be shown once and cannot be retrieved again.
  • If you lose this value, you’ll need to create a new client secret.

Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Microsoft Outlook:
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 Microsoft Outlook
  • 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 Microsoft Outlook.