Microsoft Outlook API Integration Profile

Creating Test/Developer account

An Azure account that has an active subscription.

• Create an account for free.
• The Azure account must have permission to manage applications in Microsoft Entra ID. Any of the following Microsoft Entra roles include the required permissions:
  • Application administrator
  • Application developer
  • Cloud application administrator
• Completion of the Set up a tenant quickstart.

Creating OAuth Application

Full article: Register an application with the Microsoft identity platform.

First of all you will need to have an MS Azure account. (See more...)

Quick step-by-step guide:

1. Sign in to the Microsoft Entra admin center.

2. Expand the Identity menu > expand Applications > select App registrations > New registration.

3. Enter a display Name for your application.

4. For the sign-in audience, select:
   Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)

   This option is recommended as it:

   • Supports all required scopes

   • Works with both organizational and personal accounts

   • Provides maximum compatibility

   Important: The audience type cannot be changed after registration due to system limitations.

5. Add the following Redirect URI: https://api.integration.app/oauth-callback

6. Select Register to complete the initial app registration.

When registration finishes, the Microsoft Entra admin center displays the app registration's Overview pane. You'll see the Application (client) ID there - save it somewhere.

7. Configure Authentication:

• Under Manage, select Authentication.
• Under Platform configurations, select Add a platform.
• Under Configure platforms, select Web.
• Select Configure to complete the platform configuration.

8. Add credentials:

• Under Manage, select Certificates & secrets > Client secrets > New client secret.
• Select an expiration for the secret or specify a custom lifetime.
• Select Add.
• Save the secret's value for use in your client application code. This secret value is NEVER displayed again after you leave this page.

9. Configure API permissions:

• Under Manage, select API permissions > select Add API permissions.
• Select Microsoft Graph > select Delegated.
• Enter the necessary permissions for your app and select Add permissions:
  • Calendars.ReadWrite
  • Contacts.ReadWrite
  • email
  • Mail.ReadWrite
  • Mail.Send
  • offline_access
  • openid
  • profile
  • User.Read.All
  • User.Read