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

# Workday

> Connect BonData to Workday for HCM and financial data

Workday is a cloud platform for human capital management (HCM) and financial management used by large enterprises to run HR, payroll, and finance. With BonData, you can connect to your Workday account to read, enrich, and sync your HCM and finance data within Agent workflows.

## Workday OAuth Setup

BonData connects to Workday using an API Client for Integrations with the OAuth 2.0 refresh token grant.

### Step 1: Find Your Tenant and REST API Endpoint

1. Log in to Workday
2. Search for the **View API Clients** task
3. Note your **Tenant** name and the **Workday REST API Endpoint** (for example, `https://wd2-impl-services1.workday.com/ccx/api/v1/yourtenant`)

### Step 2: Register an API Client

1. Search for and open the **Register API Client for Integrations** task
2. Enter a **Client Name** (e.g., `BonData Integration`)
3. Set the **Non-Expiring Refresh Tokens** option as needed
4. Select the required **Functional Areas / Scopes** (for example, Staffing, Compensation, and Financial Accounting)
5. Click **OK**
6. **Copy the Client ID and Client Secret** shown on the confirmation screen

### Step 3: Generate a Refresh Token

1. Search for the **View API Clients** task and open your registered client
2. Under **API Clients for Integrations**, select **Manage Refresh Tokens for Integrations**
3. Choose the integration system user and generate a refresh token
4. **Copy the Refresh Token** - it is only shown once

<Note>
  Workday scopes control which objects your client can read. Confirm the security groups assigned to the integration system user include access to the domains you plan to sync.
</Note>

### Step 4: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **Workday**
2. Enter your **Tenant**, **REST API Endpoint**, **Client ID**, **Client Secret**, and **Refresh Token**
3. Click **Connect**

## Required Fields

| Field             | Description                                             |
| ----------------- | ------------------------------------------------------- |
| Tenant            | Your Workday tenant name                                |
| REST API Endpoint | Your Workday REST API base URL                          |
| Client ID         | Client ID from the registered API client                |
| Client Secret     | Client Secret from the registered API client            |
| Refresh Token     | Refresh token generated for the integration system user |

## Available Data

Once connected, BonData can sync the following Workday objects:

* **Workers** - Employee and contingent worker records
* **Organizations** - Supervisory, company, and cost center organizations
* **Positions** - Positions and job profiles
* **Compensation** - Compensation plans and grades
* **Time Off** - Time off and absence records
* **Financial Accounts** - Ledger accounts and financial dimensions
