---
sourceDocument: Australia Employee Service Management
sourceDocumentLink: https://www.servicenow.com/docs/r/employee-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Configure Application Registry on the ServiceNow instance

# Configure Application Registry on the ServiceNow instance {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

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.

* [Edit existing Microsoft Teams Chat self-configured app application registry](https://www.servicenow.com/docs/pBTC0CdnQTHVhBCu2H~lxA#edit-ms-teams-chat-single-tenant-app-reg "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.") (Recommended)
* [Create an application registry for Microsoft Teams chat self-configured app](https://www.servicenow.com/docs/pBTC0CdnQTHVhBCu2H~lxA#create-ms-teams-chat-single-tenant-app-reg "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.")
{#app-registry-chat-single-tenant__ul_qkq_tbt_mwb}

## Edit existing Microsoft Teams Chat self-configured app application registry {#ariaid-title2}

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 AllSystem OAuthApplication 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. AllServiceNow 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 {#ariaid-title3}

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 AllSystem OAuthApplication Registry.
2. Select New.
3. Select  Connect to a third party OAuth Provider.
4. On the form, fill in the fields.  
   {#create-ms-teams-chat-single-tenant-app-reg__table_yqx_1h3_wqb__entry__2}

   | Field | Description |
   |:-|:-|
   | Name | Name to uniquely identify the record. For example, enter: Microsoft Teams chat self-configured app |
   | Client ID | Client ID created in Azure portal. Provide the value of the Azure application ID in this field. |
   | Client Secret | The 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](https://www.servicenow.com/docs/ckPqV0GPnLhuGLt01bW6zg "Create a Microsoft Azure application in Microsoft Azure portal to enable agents to import the conversations from Microsoft Teams to ServiceNow."). |
   | Authorization URL | Authorization 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 URL | Token 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 URL | Redirect URL that includes the instance URL with the format https://\<instanceURL\>/oauth_redirect.do Update the \<instanceURL\> value with your instance URL. |
   [Table 1. Application Registries - Microsoft Teams Chat for Single Tenant]

   {#create-ms-teams-chat-single-tenant-app-reg__table_yqx_1h3_wqb}
5. Select OAuth Entity Scopes related list.
6. Add the following scopes.  
   * Enter <kbd class="ph userinput">Default</kbd> in Name and enter <kbd class="ph userinput">.default</kbd> in OAuthscope.
   * Enter <kbd class="ph userinput">Offline Access</kbd> in Name and enter <kbd class="ph userinput">offline_access</kbd> in OAuthscope.
   {#create-ms-teams-chat-single-tenant-app-reg__ul_ebn_22s_mwb}
7. Select Save.  
   System generates an OAuth Entity profile.
8. See OAuth Entity Profile details in the related list OAuth Entity Profiles.
9. Open the OAuth Entity Profile record and copy the Sys ID.
10. Navigate to AllServiceNow for Microsoft 365Properties.
11. 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.
12. 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.
13. Select Save.

*[\>]: and then