> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Workday

> Bring your team's time-off into On-call schedules from Workday

Bring your team's time-off from Workday into incident.io, so we can surface holidays alongside your On-call schedule shifts.

## Connect Workday directly

<Note>
  Direct HRIS integrations are available on the [Enterprise plan](https://incident.io/pricing), and you'll need the
  **Manage organisation settings** permission to install one.
</Note>

Connecting Workday takes a few steps in Workday itself, so you'll need **administrator** permissions there. You'll gather a handful of details along the way and paste them into incident.io: your web services endpoint, tenant name, client ID and secret, token endpoint, and a refresh token. Keep both Workday and incident.io open as you work through the steps below.

### 1. Start the connection in incident.io

First, head to [Settings → Integrations → Workday](https://app.incident.io/~/settings/integrations/workday) within the incident.io dashboard to begin the OAuth flow. It'll prompt you for each value below in turn.

### 2. Find your web services endpoint

1. In Workday, search for **Public Web Services**

2. Find **Human Resources (Public)**, open its three-dot menu and choose **Web Services > View WSDL**

3. Scroll to the bottom of the page (it can take a few seconds to load) and copy the URL prefix under **Human\_ResourcesService** (it looks like `https://wd2-impl-services1.workday.com/ccx`)

   <img src="https://mintcdn.com/incidentio-18bb4170/pYZgVjxDE3fh0t9W/images/help-centre/connect-workday/view-wsdl.png?fit=max&auto=format&n=pYZgVjxDE3fh0t9W&q=85&s=91504792f493e060ed3572eed6559617" alt="The web services URL prefix to copy under Human_ResourcesService" width="1864" height="192" data-path="images/help-centre/connect-workday/view-wsdl.png" />

4. Enter this as the **Web Services Endpoint URL prefix** in incident.io, then continue

### 3. Enter your tenant name

1. Your tenant name is part of that web services URL (for example `acme`)

   <img src="https://mintcdn.com/incidentio-18bb4170/pYZgVjxDE3fh0t9W/images/help-centre/connect-workday/web-services-endpoint-url.png?fit=max&auto=format&n=pYZgVjxDE3fh0t9W&q=85&s=697951e383ca0410da700bbfdb2d8183" alt="The tenant name highlighted in the Workday web services URL" width="1864" height="192" data-path="images/help-centre/connect-workday/web-services-endpoint-url.png" />

2. Enter the tenant name in incident.io, then continue

### 4. Register an API client

1. In Workday, search for the task **Register API Client for Integrations**
2. Enter a **Client Name**
3. Under **Scope (Functional Areas)**, select **Staffing**, **Time Off and Leave**, **Tenant Non-Configurable**, **Public Data**, and **Contact Information**
4. Check both **Non-Expiring Refresh Tokens** and **Include Workday Owned Scope**, then click **OK**
5. Copy the generated **Client ID** and **Client Secret**, then click **Done**
6. Enter the Client ID and Client Secret in incident.io, then continue

### 5. Generate a refresh token

1. In Workday, search for **View API Client** and open the **API Clients for Integrations** tab
2. Copy your **Token Endpoint**
3. Open the API client you created in step 4, then use its three-dot menu to choose **API Client > Manage Refresh Tokens for Integrations**
4. Add a Workday user in the **Workday Account** field and copy the generated **Refresh Token**
5. Enter the Token Endpoint and Refresh Token in incident.io, then submit to finish linking
