---
sourceDocument: Zurich ServiceNow AI Platform Administration
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/platform-administration

 Release :

    - zurich

ft:locale :

    - en-US

ft:publication_title :

    - Zurich ServiceNow AI Platform Administration

ft:clusterId :

    - platadm

bundleId :

    - platadm

workflow :

    - Platform


---

# Configure source system

# Configure Zendesk for external content indexing {#ariaid-title1}

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

Create an API token in Zendesk Admin Center to allow the Zendesk Guide external content connector to access your Zendesk source system.

## Before you begin

You need administrator access to your Zendesk instance.

Role required: none

## About this task

The Zendesk Guide external content connector retrieves documents and user permissions from your Zendesk source system using the Zendesk API.

To allow the connector to access your Zendesk source system via the Zendesk API, you must create an API token in the Zendesk Admin Center. Your connector administrator can use this API token to configure the Zendesk Guide external connector for proper connection to your source system.

## Procedure

1. Navigate to https://\<subdomain\>.zendesk.com, where `<subdomain>` is the unique identifier for your Zendesk instance.
2. Log in with your Zendesk administrator credentials.
3. Open the app menu by selecting its icon ![](), then select Admin Center.  
4. In the Admin Center menu, navigate to Apps and integrationsAPIsOAuth clients.  
   If the Admin Center menu labels aren't shown, select the Apps and integrations icon ![]() to expand the menu and navigate.
5. On the Zendesk OAuth clients page, select Add OAuth client.  
   The Add OAuth client page appears.
6. On the Add OAuth client page, fill in the fields.  
   {#configure-zendesk-guide-external-content-indexing__table_y32_hsr_tfc__entry__2}

   | Field | Description |
   |-|-|
   | Name\* (required) | Enter a name for your new OAuth 2.0 client application. As an example, you might enter <kbd class="ph userinput"><span class="keyword">Zendesk</span> Guide external content connector</kbd>. |
   | Description\* | Enter a short description for your new OAuth 2.0 client application. This description is shown to users when they're asked to grant access to the application. As an example, you might enter <kbd class="ph userinput">App that allows the ServiceNow Zendesk Guide external content connector to access our Zendesk source system.</kbd>. |
   | Company\* | Enter the name of your organization. As an example, you might enter <kbd class="ph userinput">Example.com</kbd>. |
   | Identifier\* | Enter the identifier string you want to use when referring to your new OAuth 2.0 client application in code. A default identifier is automatically generated from the application name you enter, but you can override it if you want to use a different value. Important: Your connector administrator needs this client identifier when configuring the Zendesk external content connector. |
   | Client kind | Select Confidential. |
   | Redirect URLs | Enter <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do</kbd>, where <kbd class="ph userinput">&lt;instance-name&gt;</kbd> is the hostname for your ServiceNow AI Platform® instance where you will create and run the external content connector. As an example, you might enter <kbd class="ph userinput">https://example.service-now.com/oauth_redirect.do</kbd>. |
   [ ]

   {#configure-zendesk-guide-external-content-indexing__table_y32_hsr_tfc} {#configure-zendesk-guide-external-content-indexing__choose-client-identifier-step}
{#configure-zendesk-guide-external-content-indexing__choose-client-identifier-step}
7. Select Save.  
   Zendesk adds your new OAuth 2.0 client application and displays its generated client secret at the bottom of the Add OAuth client page.
8. Copy your new OAuth 2.0 client application's Secret and save it in a secure location.  
   Important:  
   Your connector administrator needs this client secret when configuring the Zendesk external content connector. {#configure-zendesk-guide-external-content-indexing__save-client-secret-step}
{#configure-zendesk-guide-external-content-indexing__save-client-secret-step}
9. Select Save.  
   Zendesk updates your new OAuth 2.0 client application with the generated secret. Your new application appears on the Zendesk OAuth clients page.

## What to do next

Provide the following items to your connector administrator:

* The OAuth 2.0 client identifier that you entered in step [6](https://www.servicenow.com/docs/YTRO55SMV2JAAA8LQOuAQQ#configure-zendesk-guide-external-content-indexing__choose-client-identifier-step).
* The client secret that you saved in step [8](https://www.servicenow.com/docs/YTRO55SMV2JAAA8LQOuAQQ#configure-zendesk-guide-external-content-indexing__save-client-secret-step).
{#configure-zendesk-guide-external-content-indexing__ul_rl2_xjd_tdc}

Your connector administrator needs these settings to configure a Zendesk Guide external content connector to retrieve searchable content and security principals from your Zendesk source system.

For details on creating and configuring a Zendesk Guide external content connector, see [Create a Zendesk Guide external content connector](https://www.servicenow.com/docs/l8~R7gDkBpo9mRe7j5Q5BA "Create an external content connector to retrieve searchable content and security principals from your Zendesk source system.").

*[\>]: and then