Skip to main content

How can we help you?

Search

Workday - How do I link using OAuth?

Overview

To authenticate your Workday account, you will need to provide the following information:

  • WSDL
  • Workday Tenant Name
  • Client ID
  • Client Secret
  • Refresh Token
  • Token Endpoint

Prerequisites

Please ensure you fulfill all the requirements to set up the integration:

  • You have Administrator permissions in your company's Workday instance

Step 1: Obtain the web services endpoint URL

  1. Search in Workday for Public Web Services

     

  2. Find Human Resources (Public) if you are connecting Workday HRIS.

  3. Click the three dots to access the menu. Click Web Services > View WSDL

     

  4. Navigate to the bottom of the page that opens (it may take a few seconds to load)

  5. Copy the full URL provided under Human_ResourcesService (Workday HRIS). The URL will have a format similar to https://wd2-impl-services1.workday.com/ccx

    updated_workday_url_image.png

  6. Enter the Web Services Endpoint URL prefix into the linking flow in ContactMonkey by going to Directory > click on the Sources sub-tab > locate the HRIS Sync tile and click Configure.

  1. Click Next

Step 2: Enter in your tenant name

  1. From the web services URL find your tenant name. In this example, the value is "acme"

  2. Enter the tenant name into the linking flow in ContactMonkey.

3. Click Next

Step 3: Register a new API Client for Integrations

  1. In the Search field, select the Task Register API Client for Integrations.

     

  2. On the Register API client for Integrations page, in the Client Name field, enter the Client Name, Scope (Functional Areas), and check Non-Expiring Refresh Tokens and Include Workday Owned Scope. Add the following Scope (Functional Areas) depending on the category:
HRIS
Staffing

Time Off and Leave

*if you need access to Time Off data

Tenant Non-Configurable
Public Data
Contact Information

Screenshot 2025-09-25 at 11.27.22 AM.png

3. Click Ok. Save the Client Secret and Client ID. Click Done.

4. Enter the Client Secret and Client ID to the linking flow in ContactMonkey.

5. Click Next

Step 4: Generate a non-expiring Refresh Token

  1. In the Search field, select View API Client.

2. On the View API Clients page, click the API Clients for Integrations tab. Save your Token Endpoint.

3. Click the client you created in Step 3: Register a new API Client for Integrations

4. Open the three dots > API Client > Click on Manage Refresh Tokens for Integrations

5. On the Manage Refresh Tokens for Integrations page, in the Workday Account field add a user. Save your Refresh Token.

6. Add your Token URL and Refresh Token to the linking flow in ContactMonkey.

7. Click Submit