# Get Workday Job Requisition

Enable Risotto to look up job requisition information from Workday by requisition ID

Enable Risotto to look up job requisition information from Workday by requisition ID (e.g., `R018777`). This tool uses Workday's Query Language (WQL) API to retrieve recruiting data on demand.

## Authentication

This tool uses an existing Workday connection configured on **Settings > Integrations > Workday**. You'll need an Integration System User (ISU) in Workday with permissions to query job requisition data via the WQL API.

## Setup Requirements

### Prerequisites

Before configuring this tool, ensure you have:

1. **Workday tenant with API access enabled**
2. **Integration System User (ISU)** configured in Workday
3. **Risotto connected to Workday** on **Settings > Integrations > Workday**

### Required Workday Permissions

The ISU must have the following Domain Security Policies:

- **Workday Query Language (WQL)**: Domain: Workday Query Language Permission: Get Grants access to the WQL API endpoint
- **Job Requisition Data**: Domain: Recruiting or Job Requisition Data (exact name varies by tenant) Permission: Get Grants read access to job requisition data

### Step 1: Configure ISU Permissions in Workday

1. **Open the Integration Security Group**

   Go to **Workday > Security > Integration System Security Groups** and find or
   create the security group for your ISU.

2. **Add Domain Security Policies**

   Add the following domain security policies to the security group:

   - `Workday Query Language` → `Get`
   - `Job Requisition Data` (or `Recruiting`) → `Get`

3. **Activate Security Changes**

   Search for **Activate Pending Security Policy Changes**, review the pending
   changes, add a comment, and click **OK** to activate.

   > **Warning:** Changes won't take effect until activated. This step is critical!

### Step 2: Verify Access

Test that the ISU has access by running this WQL query in Workday:

```sql
SELECT jobRequisitionId, jobPosting_JobPostingTitle
FROM jobRequisitions
LIMIT 1
```

If it returns data, permissions are configured correctly. If you get a 403 or empty results, check the domain security policies.

### Step 3: Enable the Tool in Risotto

1. **Navigate to Tools**

   In the Risotto Dashboard, select **Tools** in the sidebar.

2. **Find the Tool**

   In the **Tool groups** list, select **Workday**. Find **Get Workday Job
   Requisition**.

3. **Enable the Tool**

   Click **Enable** to activate the tool.

## Usage

Users can look up job requisitions by posting the requisition ID in various formats:

- `R018777`
- `R-018777`
- `018777`

The tool returns:

- Job Title
- Worker Type
- Location
- Hiring Manager
- Department
- Status
- Target Hire Date

## Troubleshooting

### Failed to look up job requisition

**Possible causes:**

- **Workday not connected**: Check **Settings > Integrations > Workday**
- **ISU missing WQL permissions** — Add the `Workday Query Language` domain with `Get` access
- **ISU missing recruiting permissions** — Add the `Job Requisition Data` or `Recruiting` domain with `Get` access

### Empty or partial results

Some fields may return empty if:

- The requisition doesn't have that data populated in Workday
- Field-level security restricts access to specific fields

### 403 Forbidden errors

**Cause**: The ISU lacks domain security permissions.

**Solution**: Review and update the security group configuration in Workday to ensure the `Workday Query Language` and `Job Requisition Data` (or `Recruiting`) domains are granted with `Get` access, and that pending security changes were activated.

## Support

If you encounter issues with this tool:

1. Check the troubleshooting section above
2. Verify ISU permissions in Workday Security
3. Confirm Risotto is connected on **Settings > Integrations > Workday**
4. Contact Risotto support at <support@tryrisotto.com>

Source: https://www.tryrisotto.com/docs/integrations/tools/workday/get_job_requisition
