> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/hris/workday.md).
# Workday
Workday is an enterprise cloud platform for finance and human resources management. Connecting Workday to Harmony enables automated IT provisioning triggered by HR events, comprehensive employee lifecycle management, and data-driven workforce analytics for IT operations.
#### What the Workday integration enables
| Capability | Description |
| ---------------------- | ------------------------------------------------------------------- |
| Automated Provisioning | Trigger IT workflows automatically based on Workday HR events |
| Employee Lifecycle | Manage onboarding, transfers, and offboarding seamlessly |
| Organizational Sync | Keep employee data and org structure synchronized across IT systems |
| Lifecycle Automation | Automate IT tasks for role changes, transfers, and promotions |
Anything defined in the [Workday REST API](https://community.workday.com/sites/default/files/file-hosting/restapi) can be accessed through Harmony workflows.
#### Prerequisites
* **Workday Administrator Access**: Admin role with permissions to create Integration System Users (ISUs)
* **Permissions to configure security groups and policies**
* **Your Workday tenant name** (e.g., `company`)
* **Harmony Account**: Active Harmony workspace with admin privileges
#### Connect Workday to Harmony
**Step 1: Create Integration System User in Workday**
1. Log in to your Workday tenant
2. Search for **Create Integration System User** and fill in:
* **User Name**: `HarmonyIntegration`
* **Password**: Create a strong password (no `&`, `<`, or `>` characters)
3. Search for **Maintain Password Rules** and add the ISU to **System Users exempt from password expiration**
4. Search for **Create Security Group**, select **Integration System Security Group (Unconstrained)**, and name it `Harmony Integration Group`
5. Assign `HarmonyIntegration` to the new security group
6. Search for **Maintain Permissions for Security Group** and add the following domain security policies (Get Only):
* Worker Data: Public Worker Reports
* Person Data: Name
* Person Data: Work Contact Information
* Worker Data: Current Staffing Information
* Worker Data: Organization Information
* Worker Data: Workers
7. Search for **Activate Pending Security Policy Changes** and confirm
**Step 2: Register API Client in Workday**
1. Search for **Register API Client for Integrations**
2. Configure:
* **Client Name**: `Harmony Workday API Client`
* **Non-Expiring Refresh Tokens**: Enabled
* **Grant Type**: Client Credentials
3. Click **Save** and copy the **Client ID**, **Client Secret**, and **Token Endpoint URL**
4. Search for **Manage Refresh Tokens for Integrations**, select your API client, add the ISU as **Authorized User**, and copy the generated **Refresh Token**
**Step 3: Navigate to Integrations**
1. Log into your Harmony dashboard
2. Navigate to **Settings** > **Integrations**
3. Find **Workday** under **HRIS** and click **Connect**
4. Enter your **Tenant Name**, **Client ID**, **Client Secret**, and **Refresh Token**
Each configuration field includes a descriptive label to guide you through the setup. For select and multi-select fields, supporting descriptions are displayed alongside each option so you can clearly understand what each choice does before confirming your configuration.
5. Click **Connect**
Once connected, Harmony automatically pulls employee data from your Workday instance to keep your team and agent data synchronized with your support platform.
#### What Harmony Syncs
**From Workday:**
* Employee profiles (name, email, employee ID)
* Job information (title, position, job profile)
* Department and cost center
* Manager relationships and organizational hierarchy
* Work location and address
* Employment status and type
* Employment dates (hire date, termination date)
* New hire, termination, job change, and transfer events
#### Use Cases
Day-One Ready Onboarding
Trigger complete IT setup when new employees are added in Workday, ensuring accounts and equipment are ready on day one
Role Change Management
Automatically adjust access when employees change roles or departments in Workday
Seamless Offboarding
Automate access revocation and asset recovery when employees are terminated in Workday
Compliance & Audit
Maintain audit trails linking IT access to Workday employee records for compliance reporting
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.harmony.io/integrations/hris/workday.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.