---
updatedAt: 2026-04-20T09:59:29.000Z
agentTools:
  projectIndex: https://help.zluri.com/llms.txt
---

# 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):

      <Table align={["left","left"]}>
        <thead>
          <tr>
            <th style={{ textAlign: "left" }}>
              Zluri Scope
            </th>

            <th style={{ textAlign: "left" }}>
              Workday Scope
            </th>
          </tr>
        </thead>

        <tbody>
          <tr>
            <td style={{ textAlign: "left" }}>
              Read Users(Mandatory)
            </td>

            <td style={{ textAlign: "left" }}>
              * Staffing
              * Personal Data
              * Contact Information
              * System
              * Organization and Roles
              * Integration
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read User Sessions(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * System
              * System Health Dashboard
              * Tenant Non-Configurable
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read Activities(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * System
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read Entries(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * Expenses
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read Invoices(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * Customer Accounts
              * Project Billing
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read Contracts(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * Procurement
              * Supplier Contracts
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read Expense Items(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * Expenses
            </td>
          </tr>

          <tr>
            <td style={{ textAlign: "left" }}>
              Read Supplier Invoices(Optional)
            </td>

            <td style={{ textAlign: "left" }}>
              * Procurement
              * Supplier Contracts
            </td>
          </tr>
        </tbody>
      </Table>
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](https://app.zluri.com/integrations/catalog), search for “workday”, and click ➕ **Connect integration** under **Workday (OAuth)**.

   ![](https://files.readme.io/f473bdc27f1d38c2ad24a09414296a2c00d05484e3bd7bb68dff9888730fb106-image.png)
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.

   <Image align="center" width="70% " src="https://files.readme.io/bbd9b694a10f3550560b04d939b099f3fd87a9dc953f4d29a0b038ce6a7f4ef0-image.png" />
3. Enter the previously obtained  **Base URI**, **Client ID**, **Client Secret**, **Tenant Name**, and **Authorization Endpoint**, then click **Connect**.

   <Image align="center" width="70% " src="https://files.readme.io/b45f3851d9a44ab183a7629c1d78892c4d08d9b556cd886b2d7bbc5aa1862f54-image.png" />
4. Give the connection a name and description, and you’re ready to go!

Got questions? Feel free to [submit a ticket](https://support.zluri.com/support/tickets/new) or contact us directly at <support@zluri.com>.