---
title: "Get Started with UC&C"
slug: "ucc-getting-started-teams"
updated: 2025-10-31T13:35:30Z
published: 2025-10-31T13:35:30Z
canonical: "support.controlup.com/ucc-getting-started-teams"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.controlup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams Integration

Follow this article to set up the Microsoft Teams integration with ControlUp for Desktops so that you can monitor Microsoft Teams usage and call quality.

## Prerequisites

To get Teams data, your ControlUp tenant must be able to communicate with the Graph API. If you have extra conditional access policies on your Graph API, you must allow access from your tenant (https://<yourTenantName>.sip.controlup.com). You can find your tenant name on the [agent downloads page](/v1/docs/edge-dx-agent-installation).

## Step 1 - Register an application in Entra ID

1. In Entra ID, go to **App registrations > New registration**.
2. In the **Register an application** form, enter a **Name** for the application.
3. Click **Register**.
4. Take note of the following values because you'll need to add them into ControlUp's settings.
  - Application (client) ID
  - Directory (tenant) ID ![Highlighting the Application (client) ID and Directory (tenant) ID in Entra ID.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/EntraEssentials.png)

## Step 2 - Add permissions to the application

1. In Entra ID, go to **API permissions > Add a permission**.
2. Select **Microsoft Graph**.
3. Select **Application permissions**.
4. Select the permission `CallRecords.Read.All` and click **Add permissions**
5. After adding the permission, click **Grant admin consent for Default Directory**. Note that this step must be performed by an Entra ID global administrator. ![Grant admin consent for Default Directory button.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/UCC-GrantAdminConsent.png)

## Step 3 - Create a client secret

1. In Entra ID, go to **Certificates & secrets > New client secret**.
2. Enter a name and expiration date for the client secret. If the client secret expires and is not replaced with a new one, then ControlUp can't use the connection.
3. Take note of the client secret **Value** because you'll need to add it to ControlUp's settings. You must copy the value and save it somewhere safe now because you won't be able to view it again. ![Client secret Value field.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/ClientSecretValue.png)

## Step 4 - Set up the integration in ControlUp

1. In ControlUp, go to **Unified Communications > Configuration**.
2. In the **Teams** section, add the following values you got from [Step 1 - register an application in Entra ID](/v1/docs/ucc-getting-started-teams#step-1-register-an-application-in-entra-id):
  - Tenant ID
  - Application ID ![Enter Tenant ID and Application ID to the Teams settings in ControlUp.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/ControlUpEssentials.png)
3. Add the client (application) secret value you got from [Step 3 - Create a client secret](/v1/docs/ucc-getting-started-teams#step-3-create-a-client-secret) ![Add application secret value.](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/ControlUpSecret.png)
4. Click **Configure**.