jsn / ServiceNow, simplified.
AustraliaREFERENCE GUIDE

Set up the Microsoft Teams Graph spoke

ServiceNow documentation·4 min readView source ↗
On this page

Set up the Microsoft Teams Graph spoke

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

Before you begin

  • Request an Integration Hub subscription.

  • Activate the Microsoft Teams Graph spoke.

  • Role required: admin.

Register an application using the Microsoft Azure portal

Provide authorization to the ServiceNow instance by registering an application in Microsoft Entra ID (formerly Microsoft Azure Active Directory).

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 in Microsoft Entra ID documentation.

  2. Register your application in Azure portal. For instructions on registering an application, see Tutorial: Register an app with Microsoft Entra ID in the Microsoft Docs.

  3. Copy and record the Application ID for later use.

  4. Add the Redirect URL in this format: https://<instance-name>.service-now.com/oauth_redirect.do.

    For more information, see Authentication and authorization for Azure Time Series Insights API in Microsoft Docs.

  5. For the Required Permissions, select Microsoft Graph.

    For more information, see Permissions and consent in the Microsoft identity platform in Microsoft Docs.

    For information about the permissions required to use the spoke actions, see the Spoke actions section in Microsoft Teams Graph Spoke. Provide permissions as per your requirement. For more information about the permissions, see Microsoft Graph REST API v1.0 reference in Microsoft Docs.

  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

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 All > Process Automation > Workflow Studio.

  2. Select the Integrations tab.

  3. Under Connections, toggle and enable the Outbound connections.

  4. Configure the Microsoft Teams Spoke connection.

    1. Locate the Microsoft Teams Spoke connection alias and select View Details.

      • To configure the default connection and credential alias record that is shipped along with the Microsoft Teams spoke, select View Details.

        [Omitted image "ms-teams-spoke-tile.jpg"] Alt text: Connection for the Microsoft Teams Spoke

      • To manage more than one Microsoft Teams spoke connection records, you should create a child alias record by clicking Add Connection. For more information about using multiple connections, see Supporting multiple connections. If you're configuring the spoke for the first time, select Configure. Otherwise, select Edit.

      [Omitted image "ms-teams-spoke-configure.jpg"] Alt text: Initial connection configuration

    2. On the form, fill in these fields:

<table id=“table_shd_vqw_byb”><thead><tr><th>

Field

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Name

</td><td>

Name to identify the alias record associated with this connection.

</td></tr><tr><td>

Connection URL

</td><td>

Connection URL. Enter https://graph.microsoft.com.

</td></tr><tr><td>

API Version

</td><td>

The value is set to v1.0 by default.If you’re using any other API version, update the version number here.

</td></tr><tr><td>

Authorization URL

</td><td>

OAuth authorization code endpoint. Enter https://login.microsoftonline.com/<Directory-ID>/oauth2/v2.0/authorize.

</td></tr><tr><td>

Token URL

</td><td>

OAuth server token endpoint. Enter https://login.microsoftonline.com/<Directory-ID>/oauth2/v2.0/token.

</td></tr><tr><td>

Token Revocation URL

</td><td>

OAuth server token revocation endpoint.

</td></tr><tr><td>

OAuth Client ID

</td><td>

Application ID created during application registration.

</td></tr><tr><td>

OAuth Client Secret

</td><td>

Client secret created during application registration.

</td></tr><tr><td>

OAuth Redirect URL

</td><td>

OAuth callback endpoint. Enter https://<instance-name>.service-now.com/oauth_redirect.do.

</td></tr></tbody> </table> [Omitted image “ms-teams-spoke-conf-connection.jpg”] Alt text: Configure a connection for the Microsoft Teams spoke

3.  Select **Save and Get OAuth Token**.

  1. 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 select View Details.

      • To configure the default connection and credential alias record that is shipped along with the Microsoft Teams Graph Client Credentials, select View Details.

        [Omitted image "ms-teams-gphcc-tile.jpg"] Alt text: Connection for the Microsoft Teams Graph Client Connection

      • To manage more than one Microsoft Teams Graph Client Credentials connection records, you should create a child alias record by clicking Add Connection. For more information about using multiple connections, see Supporting multiple connections. If you're configuring the spoke for the first time, select Configure. Otherwise, select Edit.

      [Omitted image "ms-teams-gphcc-configure.jpg"] Alt text: Initial connection configuration

    2. On the form, fill in these fields:

<table id=“table_bwd_xpw_byb”><thead><tr><th>

Field

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Name

</td><td>

Name to identify the alias record associated with this connection.

</td></tr><tr><td>

Connection URL

</td><td>

Connection URL. Enter https://graph.microsoft.com.

</td></tr><tr><td>

API Version

</td><td>

The value is set to v1.0 by default.If you’re using any other API version, update the version number here.

</td></tr><tr><td>

Token URL

</td><td>

OAuth server token endpoint. Enter https://login.microsoftonline.com/<Directory-ID>/oauth2/v2.0/token.

</td></tr><tr><td>

OAuth Client ID

</td><td>

Application ID created during application registration.

</td></tr><tr><td>

OAuth Client Secret

</td><td>

Client secret created during application registration.

</td></tr></tbody> </table> [Omitted image “ms-teams-gphcc-conf-connection.jpg”] Alt text: Configure a connection for the Microsoft Teams Graph Client Credentials

3.  Select **Save and Get OAuth Token**.

Result

The Microsoft Teams Graph spoke is set up and Microsoft Teams account is integrated with your ServiceNow instance.

Keep exploring.

Find another answer, or bring this documentation into your own tools.

Search the library →Read via the REST API ↗