Workday authentication guide

This guide explains how to acquire credentials and create an OAuth connection for the Workday Load, Workday, and Workday Custom Reports components.

Note

You must have access to a Workday account that allows you to use Workday Public Web Services.

---

Acquire Workday credentials

To authenticate and configure a Workday component in Designer, you need the following Workday credentials.

• Credentials needed to create an OAuth connection:
  • Token endpoint
  • Authorization endpoint
  • Client ID
  • Client secret
• Credentials needed to configure the component:
  • Host name
  • Tenant ID

Find your Workday credentials as described below, then use these to create a Workday OAuth connection in the Data Productivity Cloud and to configure the component's Host and Tenant properties.

Token endpoint, authorization endpoint, and client ID

1. Log in to your Workday account, and ensure you are on the Workday homepage by clicking on the Workday icon in the top left.
2. Search for and click the View API Clients report.
3. Copy the Token Endpoint and Authorization Endpoint URLs.
4. Click the API client for which you need credentials.
5. Copy the Client ID.

Client secret

You should already have your Workday client secret from when you created the API client in Workday.

Host name

1. Log in to your Workday account, and ensure you are on the Workday homepage by clicking on the Workday icon in the top left.
2. Navigate to Public Web Services, then click the three dots ..., and then click Web Service.
3. Click View WSDL in the resulting message to open the WSDL file.
4. In the WSDL file, locate soapbind:address.
5. Copy the hostname from the location element.
6. When configuring your Workday component, enter this string in the Host property.

Tenant ID

You will find your Tenant ID in the URL displayed in the browser address bar. The ID is the string that immediately follows .com in the URL. For example, if the URL is https://your-domain.workday.com/example/home.html, then your Tenant ID would be example. Copy this string.

When configuring your Workday component, enter this string in the Tenant property.

---

Create an OAuth connection

1. Follow the instructions in OAuth, and select Workday in the Provider field.

2. Complete the additional fields using the reference table below.

   Field	Description
   Client ID	Enter the client ID for your API client from Workday.
   Client Secret	Enter the client secret for the API client.
   Authorization URL	Enter the Authorization Endpoint URL from Workday.
   Access Token URL	Enter the Token Endpoint URL from Workday.

3. Click Authorize.

4. A new browser tab will open, connecting you to the identity provider. Upon successful connection and authorization, this browser tab will close.
5. Your new OAuth connection is ready for use with the Workday components.

Got feedback or spotted something we can improve?

We'd love to hear from you. Join the conversation in the Documentation forum!