Outlook Access Requirements

Overview

To enable seamless integration with Microsoft Graph API, customers must register an application in Azure and provide the necessary credentials. This document outlines the required access configurations and steps for a successful setup.


Step 1: Register an Application in Azure

Customers must register an application in the Microsoft Azure portal following the guidelines outlined in the Microsoft Graph Authentication Guide.

Redirect URI Requirement

As part of the registration, a special Redirect URI must be configured. Your organization’s redirect URI will vary. Please confirm the appropriate Redirect URI with your Moveworks representative before proceeding.


Step 2: Provide Required Credentials

Once the application is registered, customers must provide the following credentials to enable integration:

  • Application ID (Client ID)
  • Object ID
  • Client Secret

These credentials must be securely shared with the Moveworks team to complete the integration process.


Step 3: Configure OAuth Flow in Moveworks

Moveworks uses OAuth 2.0 authentication to securely connect to Microsoft Graph API. Customers must configure the OAuth flow as specified in the OAuth 2.0 User Consent Guide.

Required OAuth Scopes

To ensure full functionality, the following OAuth scopes must be granted:

  • offline_access
  • Calendars.ReadWrite
  • Calendars.ReadWrite.Shared

These permissions allow Moveworks to access and manage calendar data as needed.


Step 4: Enable Calendar Management

Your Moveworks representative will use the provided credentials to successfully enable Calendar Management for your organization.

These Calendar Management capabilities will rely on the following APIs.

With these APIs, we will perform operations like

  • List users, get user
  • List events, get event
  • Create/update/delete event
  • Accept/tentatively accept/decline event
  • Get free/busy schedule, find meeting times