Skip to content
Configure Request-based chat on the Microsoft Azure portal › Integration for Employee Experience › Setup for integrating self-configured apps › Setup the Servicenow instance › Integrating ServiceNow with Microsoft Teams and Microsoft 365 › ServiceNow for Microsoft Teams and Microsoft 365 › Unified Employee Experience › Employee Service Management
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure Application Registry on the ServiceNow instance

Register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment.

You can register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment using one of the following methods.

Parent Topic:Register and configure the Request-based chat application on the Microsoft Azure portal

Edit existing Microsoft Teams Chat self-configured app application registry

Register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment by editing existing Microsoft Teams Chat self-configured app application registry.

Before you begin

Role required: oauth_admin

Procedure

  1. Navigate to All > System OAuth > Application Registry.

  2. Search and select Microsoft Teams Chat Single Tenant application registry.

  3. Fill in the details Client ID and Client Secret on the form.

  4. Select Save.

  5. All > ServiceNow for Microsoft 365 ** > Properties**

  6. Enable the option Set this property to true to use integration hub action for Start Chat / Import chat flows on the ServiceNow for Microsoft Teams properties form

    The OAuth profile property Sys ID of OAuth profile for single tenant setup is set to default (OOB) when shipped with application registry.

  7. Select Save.

Create an application registry for Microsoft Teams chat self-configured app

Register the Request-based chat app in your instance to use Microsoft Teams chat for self-configured app environment by creating a Microsoft Teams Chat self-configured app application registry.

Before you begin

Note: Use this procedure only if it is absolutely required.

Role required: admin

Procedure

  1. Navigate to All > System OAuth > Application Registry.

  2. Select New.

  3. Select  Connect to a third party OAuth Provider.

  4. On the form, fill in the fields.

FieldDescription
NameName to uniquely identify the record. For example, enter: Microsoft Teams chat self-configured app
Client IDClient ID created in Azure portal. Provide the value of the Azure application ID in this field.
Client SecretThe password you generated when creating the app in Microsoft Teams. For more information, see Register and configure the Request-based chat application on the Microsoft Azure portal.
Authorization URLAuthorization URL that includes the tenant ID of your app with the format https://login.microsoftonline.com/\{tenantid\}/oauth2/v2.0/authorize where is the tenant ID created during the app creation in Microsoft Teams.
Token URLToken URL that includes the tenant ID of your app with the format https://login.microsoftonline.com/\{tenantid\}/oauth2/v2.0/token where is the tenant ID created during the app creation in Microsoft Teams.
Redirect URLRedirect URL that includes the instance URL with the format https://<instanceURL>/oauth\_redirect.do Update the <instanceURL> value with your instance URL.
Image omitted: chat-single-tenant-oauth-entity.png
Microsoft Teams Chat Single Tenant form

  1. Select OAuth Entity Scopes related list.

  2. Add the following scopes.

    • Enter Default in Name and enter .default in OAuthscope.
    • Enter Offline Access in Name and enter offline_access in OAuthscope.
    • Select Save.

    System generates an OAuth Entity profile.

  3. See OAuth Entity Profile details in the related list OAuth Entity Profiles.

  4. Open the OAuth Entity Profile record and copy the Sys ID.

  5. Navigate to All > ServiceNow for Microsoft 365 > Properties.

  6. Enable the option Set this property to true to use integration hub action for Start Chat / Import chat flows on the ServiceNow for Microsoft Teams properties form.

  7. Enter the copied OAuth Entity Profile value in the field Sys ID of OAuth profile for single tenant setup. This needs to be setup if you are setting "sn_tcm_collab_hook.teams_use_ih_actions_for_single_tenant" to true.

  8. Select Save.