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, configure the Moveworks redirect URI for your organization. It isn’t published or shown in Setup today; Moveworks provides it.
Step 2: Provide Required Credentials
Once the application is registered, note these values from Azure:
- Application (client) ID
- Directory (tenant) ID
- Client Secret
You enter them yourself on the Outlook (Next Gen) connector in Step 4.
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_accessCalendars.ReadWriteCalendars.ReadWrite.Shared
These permissions allow Moveworks to access and manage calendar data as needed.
Step 4: Enable Calendar Management
Enter the app credentials on the Outlook (Next Gen) connector under Core Platform > Connectors > Built-in Connectors (OAuth2.0 User Consent Auth: Tenant (directory) ID, Client ID, Client Secret), then turn on Calendar Management under Core Platform > AI Assistant > Plugin Management. Moveworks links the connector to Calendar Management for your organization.
These Calendar Management capabilities will rely on the following APIs.
- Calendars: https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0
- Events - https://learn.microsoft.com/en-us/graph/api/resources/event?view=graph-rest-1.0
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