--- sourceDocument: Australia ServiceNow AI Platform Administration sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/platform-administration Release : - australia ft:locale : - en-US ft:publication_title : - Australia ServiceNow AI Platform Administration ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Configure source system # Configure Workday for external content indexing {#ariaid-title1} Release version: Australia Updated March 12, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes to read Create and authorize an OAuth 2.0 API client in your Workday tenant to allow the Workday external content connector to access your Workday source system. ## Before you begin You need administrator privileges for your organization's Workday tenant. You need modify access for these domains in the System functional area: * Set Up: Tenant Setup - Security * Security Administration {#configure-workday-external-content-indexing__ul_e5z_3k5_bhc} A Workday admin must have already completed the preliminary tasks shown in the following table.{#configure-workday-external-content-indexing__table_z31_wpy_1hc__entry__2} | Preliminary task | Description | |-|-| | [Configure Workday security settings](https://servicenow-prod.fluidtopics.net/DpR5mOKyKzNmQAiquu6ySQ "Create an unconstrained integration system security group in Workday. The Workday external content connector uses this security group when accessing your Workday content.") | Required task. | | [Configure access to help articles in Workday](https://servicenow-prod.fluidtopics.net/1bsEVeKWBhw5jUdlQe0BKQ "Create an article audience rule in Workday and specify it for your help articles to make them accessible by all your employees. The Workday external content connector uses the audience rule and article settings to make content and metadata from your help articles searchable.") | Optional task. Only required if you want the connector to retrieve searchable content and metadata from help articles accessible by all users in your Workday organization. | | [Configure a payslip report in Workday](https://servicenow-prod.fluidtopics.net/2PjShIoBXMukFEmRmjCDDA "Configure a custom report for payroll data in Workday. The Workday external content connector uses this report to make content and metadata from your payroll data searchable.") | Optional task. Only required if you want the connector to retrieve searchable content and metadata from payroll data. | | [Configure a Learning assignment custom report in Workday](https://servicenow-prod.fluidtopics.net/0q6Yb6s~rD1ddyMcAf1zTQ "Configure a custom report for Learning assignments in Workday. The Workday external content connector uses this custom report to make content and metadata from your Learning assignment data searchable.") and [Get Workday task code for Find Learning Assignments](https://servicenow-prod.fluidtopics.net/obcuh5BPlmj4GLmrFCzCaw "Get the task code for the Find Learning Assignments task from your Workday tenant. The Workday external content connector needs this task code to retrieve Learning assignment data from Workday.") | Optional tasks. Only required if you want the connector to retrieve searchable content and metadata from Learning assignment data. | | [Get Workday task code for My Team's Birthday](https://servicenow-prod.fluidtopics.net/1yGv9dqkWcnlTn4fPcuB~g "Get the task code for the My Team's Birthday task from your Workday tenant. The Workday external content connector needs this task code to retrieve team birthday data from the Manager hub.") and [Get Workday task code for My Team Anniversaries](https://servicenow-prod.fluidtopics.net/e_HcQVG0jjOdDrQaHBx7bA "Get the task code for the My Team Anniversaries task from your Workday tenant. The Workday external content connector needs this task code to retrieve team anniversary data from the Manager hub.") | Optional tasks. Only required if you want the connector to retrieve searchable content and metadata from Manager hub data. | [ ] {#configure-workday-external-content-indexing__table_z31_wpy_1hc} Role required: none ## About this task The Workday external content connector retrieves public help articles, benefits, learning assignments, Manager Insights Hub data, payroll information, PTO information, and vacation policies from your Workday source system using the Workday REST API. To allow the connector to access your Workday source system via the Workday REST API, you must configure and authorize an OAuth 2.0 API client in your Workday tenant. Your connector administrator can use settings copied from this OAuth 2.0 API client and your Workday tenant to configure the Workday external connector for proper connection to your source system. ## Procedure 1. Log in to your Workday tenant and record its base connection URL and tenant name. 1. Navigate to your Workday tenant and log in with developer credentials. 2. Copy the base connection URL and the tenant name for your Workday tenant and record them in a secure location. Your tenant's base connection URL is the HTTPS protocol prefix and the hostname from the Workday URL that you see after logging in. Your tenant's name is the first path element that follows the hostname in the Workday URL. As an example, if logging in takes you to https://wd-2-impl-services1.workday.com/example/d/home.htmld, your base connection URL is https://wd-2-impl-services1.workday.com and your tenant name is example. Important: Your external content connector administrator needs the base connection URL and tenant name when configuring the Workday external content connector. {#configure-workday-external-content-indexing__copy-connection-url-tenant-name-step} {#configure-workday-external-content-indexing__copy-connection-url-tenant-name-step} {#configure-workday-external-content-indexing__substeps_fs4_wk5_bhc} 2. Enable OAuth 2.0 clients in your Workday tenant. 1. In the Workday search bar, search for the Edit Tenant Setup - Security task and select it. 2. On the Edit Tenant Setup - Security form, in the OAuth 2.0 Settings section, select the OAuth 2.0 Clients Enabled option, then select OK. 3. Select Done. {#configure-workday-external-content-indexing__substeps_nzl_tk5_bhc} 3. Create a new OAuth 2.0 API client for the Workday external content connector. 1. In the Workday search bar, search for the Register API Client task and select it. 2. On the Register API Client form, fill in the fields. {#configure-workday-external-content-indexing__table_vw3_2wr_1hc__entry__2} | Field | Description | |-|-| | Client Name | Unique name for this API client. As an example, you might enter Workday external content connector. | | Client Grant Type | Select Authorization Code Grant. | | Access Token Type | Select Bearer. | | Redirection URI | Enter https://<instance-name>.service-now.com/oauth_redirect.do, replacing <instance-name> with your ServiceNow AI Platform® instance name. | | Non-Expiring Refresh Tokens | Select this option. | | Grant Administrative Consent | Select this option. | | Scope (Functional Areas) | In the drop-down list, select Custom Objects, then select all of the listed scopes. | | Include Workday Owned Scope | Select this option. | [ ] {#configure-workday-external-content-indexing__table_vw3_2wr_1hc} 3. Select OK. {#configure-workday-external-content-indexing__substeps_ozl_tk5_bhc} Your new OAuth 2.0 API client is registered. 4. Find the client ID and client secret for your new OAuth 2.0 API client. 1. Copy the client ID for your new OAuth 2.0 API client and store it in a secure location. Important: Your external content connector administrator needs this client ID when configuring the Workday external content connector. {#configure-workday-external-content-indexing__copy-client-id-step} {#configure-workday-external-content-indexing__copy-client-id-step} 2. Copy the client secret for your new OAuth 2.0 API client and store it in a secure location. Important: Your external content connector administrator needs this client secret when configuring the Workday external content connector. {#configure-workday-external-content-indexing__copy-client-secret-step} {#configure-workday-external-content-indexing__copy-client-secret-step} 3. Copy the token endpoint URL for your new OAuth 2.0 API client and store it in a secure location. Important: Your external content connector administrator needs this token endpoint URL when configuring the Workday external content connector. {#configure-workday-external-content-indexing__copy-token-url-step} {#configure-workday-external-content-indexing__copy-token-url-step} 4. Copy the authorization endpoint URL for your new OAuth 2.0 API client and store it in a secure location. Important: Your external content connector administrator needs this authorization endpoint URL when configuring the Workday external content connector. {#configure-workday-external-content-indexing__copy-auth-url-step} {#configure-workday-external-content-indexing__copy-auth-url-step} ## What to do next Provide the following items to your connector administrator: * The base connection URL for your Workday tenant that you copied in step [1.b](https://servicenow-prod.fluidtopics.net/9PAzJYhLxcmoP1Wb~_lBsw#configure-workday-external-content-indexing__copy-connection-url-tenant-name-step). * The tenant name that you copied in step [1.b](https://servicenow-prod.fluidtopics.net/9PAzJYhLxcmoP1Wb~_lBsw#configure-workday-external-content-indexing__copy-connection-url-tenant-name-step). * The client ID that you copied in step [4.a](https://servicenow-prod.fluidtopics.net/9PAzJYhLxcmoP1Wb~_lBsw#configure-workday-external-content-indexing__copy-client-id-step). * The client secret that you copied in step [4.b](https://servicenow-prod.fluidtopics.net/9PAzJYhLxcmoP1Wb~_lBsw#configure-workday-external-content-indexing__copy-client-secret-step). * The token endpoint URL that you copied in step [4.c](https://servicenow-prod.fluidtopics.net/9PAzJYhLxcmoP1Wb~_lBsw#configure-workday-external-content-indexing__copy-token-url-step). * The authorization endpoint URL that you copied in step [4.d](https://servicenow-prod.fluidtopics.net/9PAzJYhLxcmoP1Wb~_lBsw#configure-workday-external-content-indexing__copy-auth-url-step). Your connector administrator needs these items to configure a Workday external content connector to retrieve Workday content from your Workday source system. For details on creating and configuring a Workday external content connector, see [Create a Workday external content connector](https://servicenow-prod.fluidtopics.net/c~y1dntZYxwbyclS~x6KJQ "Create an external content connector to retrieve searchable content from your Workday source system.").