Integrating Microsoft Teams

Capabilities

DataGrail's Microsoft Teams integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access Identifier Categories Email
Live Data Map	System Detection

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• Microsoft Teams User Role: Cloud Application Administrator

Create an App Registration

1. Log in to the Microsoft Entra admin center.
2. Navigate to Identity, Applications, and then App registrations.
3. Select New Registration and enter the following configuration:

Registration Configuration

• Supported account types: Accounts in this organizational directory only (Default Directory only - Single tenant)
• Redirect URI: https://datagrail.io/oauth/microsoft_teams

4. Select Register and copy your Client ID and Directory (tenant) ID.
5. In the left menu, select Certificates & secrets and then New client secret.
6. Create the Client Secret and copy the value in a secure, temporary location.

Connect to DataGrail

1. In DataGrail, navigate to Integrations and select Configure New Integration to search for Microsoft Teams.
2. Enter the Client ID, Client Secret, and Directory (tenant) ID.
3. Select Login to Configure.
4. Log in to Microsoft Teams if prompted and authorize the necessary permissions to DataGrail:

Required Scopes

• offline_access
• Directory.Read.All

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Direct Contact Integrations
• Access Request Lifecycle
• Request Manager Overview
• Customizing Intake Forms

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

The Microsoft Teams integration uses the Microsoft Graph REST API v1.0:

Access Type	Synchronous

API Documentation

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.