---
sourceDocument: Yokohama Data and Automation
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Data and Automation

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the Microsoft Teams Graph spoke

# Set up the Microsoft Teams Graph spoke {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Integrate the ServiceNow instance and Microsoft Teams account by creating a custom OAuth application in Microsoft Azure portal to authenticate ServiceNow requests.
<br />

## Before you begin

* Request an Integration Hub subscription.
* Activate the Microsoft Teams Graph spoke.
* Role required: admin.
{#set-up-msteams__ul_sh4_dtg_2hb}

## Register an application using the Microsoft Azure portal {#ariaid-title2}

Provide authorization to the ServiceNow instance by registering an application in Microsoft Entra ID (formerly Microsoft
Azure Active Directory).{#register-msteams-app__ms-azure-ad}

### Before you begin

Role required: Microsoft Entra ID admin

### About this task

Complete these steps from the Microsoft Azure portal.

### Procedure

1. In the Microsoft Azure portal, copy and record the Directory ID for later use.  
   For more information, see [Get tenant and app ID values for signing in](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal#get-tenant-and-app-id-values-for-signing-in) in [Microsoft Entra ID documentation](https://docs.microsoft.com/en-gb/).
2. Register your application in Azure portal. For instructions on registering an application, see [Tutorial: Register an app with Microsoft Entra ID](https://docs.microsoft.com/en-us/powerapps/developer/common-data-service/walkthrough-register-app-azure-active-directory) in the [Microsoft Docs](https://docs.microsoft.com/en-us/).
3. Copy and record the Application ID for later use.
4. Add the Redirect URL in this format: <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do</kbd>.  
   For more information, see [Authentication and authorization for Azure Time Series Insights API](https://docs.microsoft.com/en-us/azure/time-series-insights/time-series-insights-authentication-and-authorization) in [Microsoft Docs](https://docs.microsoft.com/en-us/).
5. For the Required Permissions, select Microsoft Graph.  
   For more information, see [Permissions and consent in the Microsoft identity platform](https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-permissions-and-consent) in [Microsoft Docs](https://docs.microsoft.com/en-us/).

   For information about the permissions required to use the spoke actions, see the Spoke actions section in [Microsoft Teams Graph Spoke](https://www.servicenow.com/docs/HYf_ecE~MgZMTFeaY2HnrQ "The Microsoft Teams Graph spoke manages applications, calendar, teams, channels, chats, notifications, and webhooks in Microsoft Teams. To create, manage, or delete users and groups, use the Microsoft Entra ID spoke (formerly Microsoft Azure Active Directory spoke).").
   Provide permissions as per your requirement. For more information about the permissions, see [Microsoft Graph REST API v1.0 reference](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0) in [Microsoft Docs](https://docs.microsoft.com/en-us/).
6. Record the Client Secret for use in later configurations.

### Result

The ServiceNow application is created with Microsoft Entra ID.

## Configure connections for the Microsoft Teams Graph spoke {#ariaid-title3}

Add and configure the Microsoft Teams connections to authenticate ServiceNow requests in the Microsoft Teams Graph spoke.

### Before you begin

Role required: admin

### Procedure

1. Navigate to AllProcess AutomationFlow Designer.
2. Click the Connections tab.
3. Configure the Microsoft Teams Spoke connection.
   1. Locate the Microsoft Teams Spoke connection alias and click View Details.  
      Note:  
      Don't click Add Connection.
   2. Click Edit or if you are configuring the spoke for the first time, click Configure.
   3. On the Configure Connection form, fill in the fields.  
      {#conf-temp-msteams__table_shd_vqw_byb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Name to identify the alias record associated with this connection. |
      | Connection URL | Connection URL. Enter <kbd class="ph userinput">https://graph.microsoft.com</kbd>. |
      | API Version | The value is set to v1.0 by default. If you are using any other API version, update the version number here. |
      | Authorization URL | OAuth authorization code endpoint. Enter <kbd class="ph userinput">https://login.microsoftonline.com/&lt;Directory-ID&gt;/oauth2/v2.0/authorize</kbd>. |
      | Token URL | OAuth server token endpoint. Enter <kbd class="ph userinput">https://login.microsoftonline.com/&lt;Directory-ID&gt;/oauth2/v2.0/token</kbd>. |
      | Token Revocation URL | OAuth server token revocation endpoint. |
      | OAuth Client ID | Application ID created during application registration. |
      | OAuth Client Secret | Client secret created during application registration. |
      | OAuth Redirect URL | OAuth callback endpoint. Enter <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do</kbd>. |
      [ ]

      {#conf-temp-msteams__table_shd_vqw_byb}
   4. Click Configure and Get OAuth Token.
   {#conf-temp-msteams__substeps_kdr_rqw_byb}
4. Configure the Microsoft Teams Graph Client Credentials connection.  
   Except the Look up Schedules action, all the other calendar and webhook management spoke actions use this connection record.
   1. Locate the Microsoft Teams Graph Client Credentials connection alias and click View Details.  
      Note:  
      Don't click Add Connection.
   2. Click Edit or if you are configuring the spoke for the first time, click Configure.
   3. On the form, fill in the fields.  
      {#conf-temp-msteams__table_bwd_xpw_byb__entry__2}

      | Field | Description |
      |-|-|
      | Name | Name to identify the alias record associated with this connection. |
      | Connection URL | Connection URL. Enter <kbd class="ph userinput">https://graph.microsoft.com</kbd>. |
      | API Version | The value is set to v1.0 by default. If you are using any other API version, update the version number here. |
      | Token URL | OAuth server token endpoint. Enter <kbd class="ph userinput">https://login.microsoftonline.com/&lt;Directory-ID&gt;/oauth2/v2.0/token</kbd>. |
      | OAuth Client ID | Application ID created during application registration. |
      | OAuth Client Secret | Client secret created during application registration. |
      [Table 1. Configure Connection form]

      {#conf-temp-msteams__table_bwd_xpw_byb}
   4. Click Configure and Get OAuth Token.
   {#conf-temp-msteams__substeps_utv_spw_byb}

### Result

The spoke connections are configured and the spoke ready to be used.

*[\>]: and then