# Workday

### Setup requirements

**Authentication method**: You must use ISU (Integration System User) and OAuth; basic auth is insufficient for syncing time off data from Workday.

#### Setup steps

* **Initiate the setup from Swarmia settings**
* **Create the ISU in Workday** - This must be done first before configuring any permissions
* **Follow the** [**ISU setup guide**](https://help.merge.dev/articles/5699428-workday-how-do-i-link-my-account-with-an-integration-system-user?lang=en) - Complete the standard ISU account linking process
* **Follow the** [**guide for accessing time-off data**](https://help.merge.dev/articles/8106565-accessing-time-off-data-from-workday?lang=en) - OAuth is required to access time-off details in Workday.

#### Data required by Swarmia

The following domains and subdomains are required to match synced employees and their time off with developers in Swarmia.

* Person Data: Name
* Person Data: Public Work Email Address Integration
* Worker Data: Current Staffing Information — This is required to surface Employment Status of Employees
* Worker Data: Workers
* Worker Data: Time Off


---

# Agent Instructions: 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:

```
GET https://help.swarmia.com/settings/integrations/hr-systems/workday.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
