Skip to content

Workday® API Integration Connection

Workday® is an American on‑demand (cloud-based) financial management, human capital management and Student information system software vendor. In addition to the Data Extract method offered by Hire2Retire, we have implemented an API based approach to facilitate integration between Workday® and Directory Services. API integration is user-friendly and allows for scheduled data retrieval, enabling daily or interval-based pulls of employee data reports.

Create a Connection

The API integration of Workday® uses Basic Auth mechanism for authentication. Workday®requires the following keys to authenticate its clients using this mechanism:

  • User Name - The username for the active account.

  • Password - The password associated with the active account.

  • Tenent ID - The company name within the WSDL URL.

  • WSDL URL - The WSDL file's web address (URL) that describes the structure and operations of web services, enabling integration and interaction with external systems.

Connection page

Figure 1. Workday® API Connection Set Up page - Create Connection

Obtaining WSDL URL for Workday®

  • Log into your account as an administrator.

  • Authenticate ISU (integration system user).

  • In the search bar, type: Public web services

    Enter Required Fields

    Figure 2. Workday® search bar

  • Select the Public Web Services report

  • Hover over Human Resources and click the three dots to access the menu.

  • Select Web Services.

  • Select View WSDL.

    Enter Required Fields

    Figure 3. Public Web Services

  • Navigate to the bottom of the page that opens and you'll find the host.

  • Copy the URL text.

  • Return to the Workday API integration connection page in your Hire2Retire account and paste the URL in WSDL URL.

Make sure the service name should be correct in the WSDL URL.

Obtaining Tenent ID for Workday®

Tenent ID is the company name present in the url after service. Eg.
"{company name}/Human_Resources/v41.0?wsdl"


Once you have successfully configured the connections, you can continue with the Design section to configure the rest of the workflow following these steps in order.

  1. HR Employee Data Definition
  2. Lifecycle Business Rules
  3. Employment Status
  4. HR to AD Profile Map
  5. Organizational Unit Assignment - Only defined in on-premise Active Directory
  6. Security Group Assignment
  7. Distribution List Assignment


Once your workflow has been setup, you can optionally setup notifications and archival for your workflow.

Otherwise, you can proceed to deploy and test it on the Hire2Retire platform, see Deploy and Test Flow