---
sourceDocument: Australia ServiceNow AI Platform Capabilities
sourceDocumentLink: https://www.servicenow.com/docs/r/servicenow-platform

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia ServiceNow AI Platform Capabilities

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Configure using SGC Central

# Configure API Service Graph Connector for Azure API Management using SGC Central {#ariaid-title1}

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

Set up scheduled import jobs to pull in Azure API Management data into your CMDB.

## Before you begin

Install API Service Graph Connector for Azure API Management version 1.0.0 or later from the ServiceNow Store. For ServiceNow Store installation steps, see [Install a ServiceNow Store application](https://www.servicenow.com/docs/access?context=installing-applications-in-application-manager&version=australia&pubname=australia-platform-administration&ft:locale=en-US).  
Obtain the OAuth credentials from your Azure administrator. Make a note of the following details:

* Application (client) ID
* Client Secret
* Directory (tenant) ID
* Connection URL
{#sgcc-configure-azure-api-mgmt__configure-azure-integration_ul_erd_1hz_swb}  
Role required: The following table shows the roles required for each stage of the playbook.{#sgcc-configure-azure-api-mgmt__table_zcy_w5p_4hc__entry__2}

| Stage | Role |
|-|-|
| Prerequisites | admin |
| Setup | SGC-Admin (sn_cmdb_int_util.sgc_admin) or admin |
[Table 1. Role required for each playbook stage]

{#sgcc-configure-azure-api-mgmt__table_zcy_w5p_4hc}  
Note:  
The admin user role is required to run background scripts and to provide access to global tables to the SGC-Admin user. For information about the user roles for Service Graph Connectors, see [Service Graph Connector user roles](https://www.servicenow.com/docs/llR5whccV6~8Oi~Q_e8~xQ#cmdb-sgc-intro__section_ett_spp_4hc).

## About this task

The playbook experience for onboarding connectors is activated with SGC Central in the CMDB Workspace. To configure the SGC Central application, see [Configuring SGC Central](https://www.servicenow.com/docs/7dDf5rxNMnkcccCA02GxmQ "Set up the SGC Central application for onboarding and maintaining Service Graph Connectors and monitoring the errors related to connections added using Service Graph Connectors.") and for more information on how to interact with a playbook, see [Interact with Playbook](https://www.servicenow.com/docs/access?context=playbook-ui&version=australia&pubname=australia-build-workflows&ft:locale=en-US).  
Note:  
Alternatively, you can configure a default connection already available from the installed or draft connections in SGC Central. Go to AllService Graph Connectors, then select Setup for the connector from the menu. To learn about installed and draft connections, see [Managing connections added for Service Graph Connectors in SGC Central](https://www.servicenow.com/docs/KVfgB9KZk6vuho37K__N_Q "You can create and update connections added for Service Graph Connectors within the SGC Central view of the Service Graph Workspace or CMDB Workspace to ingest data into Configuration Management Database (CMDB) from third-party sources.").

## Procedure

1. Navigate to WorkspacesCMDB Workspace.
2. In the CMDB Workspace, select SGC Central.
3. On the Overview page, select Create connection.  
   Tip:  
   Alternatively, you can select Create connection on the All connections page.
4. On the Create connection window, select the Azure API Management connector type, and then select Create connection.
5. Complete the initial prerequisites when setting up a connection for the first time using a connector.  
   Note:  
   This step is required only during the first-time setup. See [Perform initial setup tasks when creating a connection in SGC Central](https://www.servicenow.com/docs/0vWb7VG8kY9kzX25jOf72Q "Complete the prerequisites for setting up a connection for the first time using a Service Graph Connector within the SGC Central view of the Service Graph Workspace or CMDB Workspace.").
6. Enter connection details and test the API connection for importing Azure API Management data.
   1. In the Setup stage of the playbook, select the Create and test connection activity.
   2. On the form, fill in the fields.  
      {#sgcc-configure-azure-api-mgmt__table_ahn_xtg_rmb__entry__2}

      | Field | Description |
      |:-|:-|
      | Azure API Management Connection Name | Name to identify the Azure API Management connection record. For example, <kbd class="ph userinput">Azure API Management Connection</kbd>. |
      | Connection URL | Base URL to connect to the Azure API Management service. Note: This field is automatically set to the URL to connect to the application. Leave the field value as is. |
      | OAuth Client ID | Application (client) ID of your Azure client application as noted in the [Before you begin](https://www.servicenow.com/docs/Jj70Kmijfs3ZNtdrohAs7w#sgcc-configure-azure-api-mgmt__prereq) section. |
      | OAuth Client Secret | Client Secret of your Azure client application as noted in the [Before you begin](https://www.servicenow.com/docs/Jj70Kmijfs3ZNtdrohAs7w#sgcc-configure-azure-api-mgmt__prereq) section. |
      | OAuth Token URL | Token URL of your Azure client application. Based on the region of your Azure client application, enter the token URL in one of the following formats: * Global https://login.microsoftonline.com/<var class="keyword varname">&lt;tenantid&gt;</var>/oauth2/v2.0/token * US Government https://login.microsoftonline.us/<var class="keyword varname">&lt;tenantid&gt;</var>/oauth2/v2.0/token * China https://login.partner.microsoftonline.cn/<var class="keyword varname">&lt;tenantid&gt;</var>/oauth2/v2.0/token * Germany https://login.microsoftonline.de/<var class="keyword varname">&lt;tenantid&gt;</var>/oauth2/v2.0/token {#sgcc-configure-azure-api-mgmt__ul_e5l_xdg_jcc} Where <var class="keyword varname">&lt;tenantid&gt;</var> is the tenant ID of your Azure client application as noted in the [Before you begin](https://www.servicenow.com/docs/Jj70Kmijfs3ZNtdrohAs7w#sgcc-configure-azure-api-mgmt__prereq) section. |
      [Table 2. Create and test connection form]

      {#sgcc-configure-azure-api-mgmt__table_ahn_xtg_rmb}
   3. Select Create and test connection.
   4. Once the connection test is complete, select Continue.
   {#sgcc-configure-azure-api-mgmt__substeps_p1l_fnb_gcc}
7. **Optional:** Set the configuration properties for the connection.  
   Note:  
   To skip this step, select Continue for the Set configuration properties activity.
   1. In the Setup stage of the playbook, select the Set configuration properties activity.
   2. Fill in the property details.  
      {#sgcc-configure-azure-api-mgmt__table_nn3_31v_3cc__entry__2}{#sgcc-configure-azure-api-mgmt__table_nn3_31v_3cc__entry__3}

      | Property | Description |
      | Azure API Management connection ||
      |-|-|
      | Discovery Scope | Discovery scope of the Azure client application. The available options are: Management Group :   Select Management Group when the ServiceNow service account has access to data within the Azure management group. Subscription :   Select Subscription when the ServiceNow service account has access to data within the Azure subscription only. |
      | Subscription ||
      | Subscription Id(s) | Subscription IDs of Azure API Management services. For multiple subscription IDs, separate them with commas. If the discovery scope is set to Subscription and this field is left blank, all subscriptions for the specified tenant in the credentials are discovered. |
      | Management Group ||
      | Management Group Id(s) | Management group IDs of Azure API Management services. For multiple management groups, separate them with commas. |
      | Get Nested Group Subscriptions | Option to enable retrieving data from all nested child subscriptions when Management Group is set as the discovery scope. Disable the property to exclude nested child subscriptions. |
      | Optional Exclusive Configuration ||
      | ExcludeServices | Azure API Management services that should be excluded from the connection. For multiple services, separate them with commas. All gateways except those listed in the ExcludeServices property are fetched. |
      | ResourceGroups | Resource group name of Azure API Management services. For multiple resource groups, separate their names with commas. If you leave this field empty, the data sources within the connector import data from all the available resource groups. |
      | Usage Data Configuration ||
      | CollectUsageData | option to enable usage data collection to retrieve API usage data over a specified duration. |
      [Table 3. Azure API Management configuration properties]

      {#sgcc-configure-azure-api-mgmt__table_nn3_31v_3cc}
   3. Select Continue.
   {#sgcc-configure-azure-api-mgmt__substeps_umj_3df_gcc}
8. Configure the import schedule to import data at regular intervals.
   1. In the Setup stage of the playbook, select the Configure import schedule activity.
   2. Expand the Parent scheduled data import within the Import schedules list to select the API Management Services import schedule associated with your connection.  
      Note:  
      The connection name is prefixed to the schedule name.
   3. In the Configure import schedule dialog box, select the Active check box, and then fill in the run schedule and time details.  
      For more information, see [Schedule a data import](https://www.servicenow.com/docs/access?context=t_ScheduleADataImport&version=australia&pubname=australia-integrate-applications&ft:locale=en-US#table_r53_5hm_xp).
   4. Select Save.  
      Alternatively, select Execute Now to execute the import schedule immediately.
   5. Select Continue.
   {#sgcc-configure-azure-api-mgmt__substeps_lf4_yvw_fcc}
9. In the Setup stage of the playbook, select the Confirm connection creation activity to verify whether the connection was created.

## What to do next

Select View all connections to review the connection details. The created connection appears in the Installed connections list.

You can then manage connections from the SGC Central view of the CMDB Workspace. For more information, see [Managing connections added for Service Graph Connectors in SGC Central](https://www.servicenow.com/docs/KVfgB9KZk6vuho37K__N_Q "You can create and update connections added for Service Graph Connectors within the SGC Central view of the Service Graph Workspace or CMDB Workspace to ingest data into Configuration Management Database (CMDB) from third-party sources.").
**Related concepts**   

* [API Service Graph Connector for Azure API Management](https://www.servicenow.com/docs/VmJh4glr8Q8p~_DknehxQw "Use the ServiceNow API Service Graph Connector for Azure API Management to import API details from an Azure API Management application into the Configuration Management Database (CMDB).")  
**Related reference**   

* [Target tables for storing API Service Graph Connector for Azure API Management data](https://www.servicenow.com/docs/6IlIjcRPzz_3oteikugq5w "When you complete setting up the connection, you can configure the integration to periodically pull data from an Azure API Management application. The data is saved in tables that extend from the Configuration item [cmdb_ci] classes and other non-CMDB classes.")

*[\>]: and then


