---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Configurations to use Workday HR SOAP OAuth

# Configurations to use Workday HR SOAP OAuth {#ariaid-title1}

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

Configure your ServiceNow instance to perform Workday HR SOAP based actions with OAuth 2.0.
Note:  
If you are migrating from basic auth to OAuth 2.0 for SOAP based actions, ensure to remove the basic authentication configurations before the migration.

## Generate client ID and client secret for Workday HR spoke {#ariaid-title2}

Register Workday HR spoke as the API client in your Workday account and generate client ID, client secret.

### Before you begin

Role required: admin

### Procedure

1. Log into your Workday tenant.
2. Navigate to Search and enter <kbd class="ph userinput">Register API Client for Integrations</kbd> task.
3. On the Register API Client for Integrations form, fill in the details.  
   {#gen-client-id-secret-workday-hr__table_uqv_53m_2yb__entry__2}

   | Field | Description |
   |-|-|
   | Client Name | Client name of the app. For example, enter <kbd class="ph userinput">Workday HR spoke</kbd>. |
   | Non-expiring Refresh Tokens | Option to enable refresh tokens that do not expire. |
   | Scope (Functional Areas) | Select the required functional areas. |
   | Include Workday Owned Scope | Option to select Workday owned scope. |
   [ ]

   {#gen-client-id-secret-workday-hr__table_uqv_53m_2yb}
4. Click OK.  
   Client ID and Client Secret are generated after the registration is successful.
5. Click the ellipsis button after the specified client name.
6. Select API Client \>Manage Refresh Tokens for Integrations.
7. Select your Workday Account and click OK.  
   Delete or Regenerate Refresh Token screen displays.
8. Select Generate New Refresh Token option and click OK.

### Result

A new refresh token is generated. Copy and store the refresh token for configuring system property.

## Configure system properties for Workday HR spoke {#ariaid-title3}

Configure the system properties to enable OAuth 2.0 for SOAP APIs based actions for Workday HR spoke.

### Before you begin

* [Generate client ID and client secret for Workday HR spoke](https://www.servicenow.com/docs/radEaKO3hnRr7F0~w_KwLw#gen-client-id-secret-workday-hr "Register Workday HR spoke as the API client in your Workday account and generate client ID, client secret.")
* Role required: admin
{#config-sys-properities-workday-hr__ul_j41_fdm_2yb}

### Procedure

1. Navigate to AllSystem PropertiesAll Properties.
2. In the Application column, search for <kbd class="ph userinput">Workday HR Spoke</kbd>.
3. Open the sn_workday_hr_spke.glide.hub.clientid system property.
4. Enter the Client ID generated from the Workday account in the Value field and click Update.
5. Open the sn_workday_hr_spke.glide.hub.clientsecret system property.
6. Enter the Client secret generated from the Workday account in the Value field and click Update.
7. Open the sn_workday_hr.glide.hub.refreshtoken system property.
8. Enter the refresh token generated from the Workday account in the Value field and click Update.
9. Open the sn_workday_hr_spke.glide.hub.tokenurl system property.
10. Enter the token URL generated from the Workday account in the Value field and click Update.

### Result

The required system properties are configured for the Workday HR spoke.

## Provide the Workday HR base
URL {#ariaid-title4}

Provide the base URL of your Workday HR instance in
the Connection Details \[connection_details\] table. Spoke actions based on the SOAP API, use
these details for the action execution.

### Before you begin

Role required: admin.

### Procedure

1. Navigate to AllWorkday HR SpokeConnection Details.
2. Click the Show List related list.
3. Click New.
4. On the form, fill these values.  
   {#base-url-workday-hr__table_sxd_l2g_pmb__entry__2}

   | Field | Description |
   |-|-|
   | Base URL | Base URL of the Workday instance or tenant name. Enter the base URL in this format <kbd class="ph userinput">https://&lt;workday_host_url&gt;/ccx/service/&lt;workday_tenant_name&gt;</kbd> |
   | Version | Version of the API. For example, enter <kbd class="ph userinput">v33.2</kbd>. |
   | Webservice Type | Type of web service. Select <kbd class="ph userinput">SOAP</kbd>. |
   [Table 1. Connection Details form]

   {#base-url-workday-hr__table_sxd_l2g_pmb}
5. Click Save.
{#base-url-workday-hr__steps_qfq_qph_pmb}

*[\>]: and then