Skip to content
Zendesk Guide external content connector › Configure › External Content Connectors › Search administration › Configure core features › Administer the ServiceNow AI Platform
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Configure Zendesk for external content indexing

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

Image omitted: zendesk-app-menu-icon.png
, then select **Admin Center**.
Image omitted: zendesk-admin-center.png
Admin center link in Zendesk app menu.

  1. In the Admin Center menu, navigate to Apps and integrations > APIs > OAuth clients.

    If the Admin Center menu labels aren't shown, select the Apps and integrations icon

Image omitted: zendesk-ac-apps-integrations-icon.png
to expand the menu and navigate.
  1. On the Zendesk OAuth clients page, select Add OAuth client.
Image omitted: zendesk-oauth-clients-before.png
OAuth clients page in Zendesk with Add OAuth client button.
The Add OAuth client page appears.
  1. On the Add OAuth client page, fill in the fields.
FieldDescription
Name\* \(required\)Enter a name for your new OAuth 2.0 client application. As an example, you might enter `Zendesk Guide external content connector`.
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 `App that allows the ServiceNow Zendesk Guide external content connector to access our Zendesk source system.`.
Company\*Enter the name of your organization. As an example, you might enter `Example.com`.
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 kindSelect Confidential.
Redirect URLsEnter `https://.service-now.com/oauth_redirect.do`, where `` 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 `https://example.service-now.com/oauth_redirect.do`.
Image omitted: zendesk-add-oauth-client.png
Add OAuth client page in Zendesk.

  1. 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.

  2. Copy your new OAuth 2.0 client application's Secret and save it in a secure location.

Image omitted: zendesk-save-oauth-client-secret.png
Add OAuth client page in Zendesk showing generated client secret.
**Important:** Your connector administrator needs this client secret when configuring the Zendesk external content connector.
  1. Select Save.
Image omitted: zendesk-oauth-clients-after.png
OAuth clients page in Zendesk showing new OAuth 2.0 client application.
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.
  • The client secret that you saved in step 8.

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.

Parent Topic:Zendesk Guide external content connector

sndocs is an independent community mirror and is not affiliated with or endorsed by ServiceNow.

ServiceNow, the ServiceNow logo, Now, and other ServiceNow marks are trademarks and/or registered trademarks of ServiceNow, Inc., in the United States and/or other countries. Other company and product names may be trademarks of the respective companies with which they are associated.

© 2026 ServiceNow, Inc. All rights reserved.

Documentation content is redistributed under the Apache License 2.0 from the ServiceNowDocs repository.