Back to connector

LogoMicrosoft Outlook Integration Development Guide

Add white-label customer-facing integration with Microsoft Outlook into your app with just a few lines of code.

Configure the app parameters in the integration.app platform

  • Put the Application (client) ID into Client Id and the app secret into the Client Secret
  • Add scopes your application requires to be functional or use the default ones

Understanding Microsoft Graph Scopes

The connector uses Microsoft Graph API scopes to access various Outlook resources. Here's a breakdown of the required scopes:

Mail and Calendar Scopes

  • Mail.ReadWrite - Allows reading and writing emails
  • Mail.Send - Allows sending emails as the user
  • Calendars.ReadWrite - Allows reading and writing calendar events

Contact Management

  • Contacts.ReadWrite - Allows reading and writing contacts

Authentication and Profile Scopes

  • openid - Required for sign in and getting user identifier
  • email - Access to user's primary email address
  • profile - Access to basic profile information
  • offline_access - Enables refresh token functionality

User Management

  • User.Read - Read basic user profile
  • User.Read.All - Read all users' profiles (requires admin consent)

For more detailed information about scopes and permissions, refer to:

Note: Some scopes like User.Read.All require admin consent. Make sure you have the necessary permissions before using them.