Connect

Connect Workday OAuth to Zluri

Prerequisites

  • Organization admin privileges in Workday

Integration steps

Register API client in Workday

  1. Log in to Workday.
  2. In the search bar at the top of the page, type "Register API Client" and select the corresponding task from the results. Click Register.
  3. Complete the mandatory fields as follows:
    1. Client Name: Enter a name for your API client

    2. Client Grant: Authorization Code Grant for manual authentication; Client Credentials Grant for Server-to-Server integration

    3. Access Token Type: Bearer

    4. Redirect URI: https://integrations.zluri.com/connect_callback/workdayOauth

    5. Scope(Functional areas):

      Zluri Scope

      Workday Scope

      Read Users(Mandatory)

      • Staffing
      • Personal Data
      • Contact Information
      • System
      • Organization and Roles
      • Integration

      Read User Sessions(Optional)

      • System
      • System Health Dashboard
      • Tenant Non-Configurable

      Read Activities(Optional)

      • System

      Read Entries(Optional)

      • Expenses

      Read Invoices(Optional)

      • Customer Accounts
      • Project Billing

      Read Contracts(Optional)

      • Procurement
      • Supplier Contracts

      Read Expense Items(Optional)

      • Expenses

      Read Supplier Invoices(Optional)

      • Procurement
      • Supplier Contracts
  4. Click OK
  5. Copy and securely store the Client ID, Client Secret, and Authorization Endpoint. These will be used later in the connection process.

Extract the Base URL and Tenant Name from your Workday REST API endpoint

Navigate to the View API Clients section in your Workday dashboard. Here, you can find the required credentials and endpoint information.

If your endpoint is https://services1.wd12.myworkday.com/ccx/api/v1/Zluri,
then your Base URL is https://services1.wd12.myworkday.com and your Tenant Name is Zluri.

Connect the Workday instance in Zluri

  1. Open the Integrations Catalog, search for “workday”, and click ➕ Connect integration under Workday (OAuth).

  2. Choose the scopes for the integration, and click Connect it myself. You can click the down-arrow button towards the right of a scope to find out what it does.

  3. Enter the previously obtained Base URI, Client ID, Client Secret, Tenant Name, and Authorization Endpoint, then click Connect.

  4. Give the connection a name and description, and you’re ready to go!

Got questions? Feel free to submit a ticket or contact us directly at [email protected].