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

# Workday authentication guide

export const maia = "Maia";

export const designer = "Designer";

This guide explains how to acquire credentials and create an OAuth connection for the [Workday Load](/docs/components/workday-load), [Workday](/docs/components/workday), and [Workday Custom Reports](/docs/components/workday-custom-reports) components.

<Note>
  You must have access to a Workday account that allows you to use Workday Public Web Services.
</Note>

***

## Acquire Workday credentials

To authenticate and configure a Workday component in {designer}, you need the following Workday credentials.

* Credentials needed to create an OAuth connection:
  * Token endpoint
  * Authorization endpoint
  * Client ID
  * Client secret
* Credentials needed to configure the component:
  * Host name
  * Tenant ID

Find your Workday credentials as described below, then use these to create a Workday OAuth connection in {maia} and to configure the component's **Host** and **Tenant** properties.

### Token endpoint, authorization endpoint, and client ID

1. Log in to your [Workday](https://identity.workday.com/auth/login) account, and ensure you are on the Workday homepage by clicking on the Workday icon in the top left.
2. Search for and click the **View API Clients** report.
3. Copy the **Token Endpoint** and **Authorization Endpoint** URLs.
4. Click the API client for which you need credentials.
5. Copy the **Client ID**.

### Client secret

You should already have your Workday client secret from when you created the API client in Workday.

### Host name

1. Log in to your [Workday](https://identity.workday.com/auth/login) account, and ensure you are on the Workday homepage by clicking on the Workday icon in the top left.
2. Navigate to **Public Web Services**, then click the three dots **...**, and then click **Web Service**.
3. Click **View WSDL** in the resulting message to open the `WSDL` file.
4. In the `WSDL` file, locate `soapbind:address`.
5. Copy the `hostname` from the `location` element.
6. When configuring your Workday component, enter this string in the `Host` property.

### Tenant ID

You will find your **Tenant ID** in the URL displayed in the browser address bar. The ID is the string that immediately follows `.com` in the URL. For example, if the URL is `https://your-domain.workday.com/example/home.html`, then your Tenant ID would be `example`. Copy this string.

When configuring your Workday component, enter this string in the `Tenant` property.

***

## Create an OAuth connection

1. Follow the instructions in [OAuth](/docs/guides/oauth), and select Workday in the **Provider** field.

2. Complete the additional fields using the reference table below.

   | Field             | Description                                               |
   | ----------------- | --------------------------------------------------------- |
   | Client ID         | Enter the **client ID** for your API client from Workday. |
   | Client Secret     | Enter the **client secret** for the API client.           |
   | Authorization URL | Enter the **Authorization Endpoint** URL from Workday.    |
   | Access Token URL  | Enter the **Token Endpoint** URL from Workday.            |

3. Click **Authorize**.

4. A new browser tab will open, connecting you to the identity provider. Upon successful connection and authorization, this browser tab will close.

Your new OAuth connection is ready for use with the [Workday Load](/docs/components/workday-load), [Workday](/docs/components/workday), and [Workday Custom Reports](/docs/components/workday-custom-reports) components.