Creating a Microsoft App Registration for Moveworks

Moveworks Microsoft Graph Access - via App Registration Only Method

This guide will walk you through the process of setting up a Microsoft App Registration for Moveworks for purposes of accessing the Microsoft Graph API. You will need to capture the following information for configuring Moveworks

  1. Microsoft Graph App ID
  2. Microsoft Graph Secret

Follow the below mentioned steps to create an app and provide appropriate permissions

  1. Navigate to https://portal.azure.com and select Create an App registration
  2. Type a name for the App Registration
  3. Add the required application permissions, this is typically User.Read.All, but clarify with your Implementation team if other permissions are needed.
    🚧

    Note: It is required that the permissions are granted as Application Permissions

  4. Once you have added the permission, Select Grant Consent, and make sure you click Yes, and consent to the permission.
  5. After adding consent, you should see green check marks for the application permissions you selected.
  6. Create a new secret
  7. Once you have the App ID, and secret, complete the steps below to create the connector in Moveworks Setup.

Creating the Connector in Moveworks Setup

  1. Navigate to Connectors and Select Microsoft Graph:
    1. Go to Moveworks Setup (or the admin portal) > Core Platform > Manage Connectors > System Connectors.
    2. Click on Create New, search for and select the Microsoft Graph Connector.
    3. Click Next: Add Creds.
  2. Enter Connector Name and Base URL:
    1. Provide a descriptive Name for the connector (e.g., ms_graph_groups or ms_graph_files).
    2. Set the Base URL for the Microsoft Graph API, which is typically https://graph.microsoft.com/v1.0/.
    3. Configure OAuth 2.0 Client Credentials:
    4. Select OAuth2 as the Authentication Type.
    5. Choose Client Credentials as the OAuth2 Grant Type.
    6. Input the Client ID, Client Secret, and Tenant ID you previously obtained from your Azure AD App Registration. Client ID is your App ID that you created in the steps above.
  3. Save the Connector and Validate: