---
canonical_url: "https://docs.composio.dev/toolkits/workday_raas"
markdown_url: "https://docs.composio.dev/toolkits/workday_raas.md"
product: "platform"
version: null
last_updated: null
---

# Workday RaaS

Run web-service-enabled Workday Reports as a Service (RaaS) reports with a dedicated least-privilege Workday account.

- **Category:** human resources
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 3
- **Triggers:** 0
- **Slug:** `WORKDAY_RAAS`
- **Version:** 20260918_00

## Tools

### Get Latest Stock Grant

**Slug:** `WORKDAY_RAAS_GET_LATEST_STOCK_GRANT`

Retrieve sensitive compensation data from an authorized tenant-defined Workday RaaS stock-grant report and return its unique latest row by the exact report-output grant/effective-date field verified by the caller from the tenant report as ordering grant recency. Requires tenant report and domain access through the connected Workday account. Rejects missing or malformed dates, mixed date and offset-aware date-time representations, timezone-less date-times, and ties for latest.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `report_url` | string | Yes | Full HTTPS JSON RaaS URL for the authorized tenant-defined stock-grant report. Authentication must not be embedded in it. |
| `fixed_prompts` | object | No | Optional exact report-defined Prompt XML Alias names and fixed string values. The worker alias, if present, is replaced by worker_identifier. |
| `grant_date_field` | string | Yes | Exact top-level report-output field verified by the caller as the stock-grant grant/effective date and as the report's ordering field for grant recency. Do not guess this field or its semantics. |
| `worker_identifier` | string | Yes | Worker WID: exactly 32 lowercase hexadecimal characters. |
| `worker_prompt_alias` | string | Yes | Exact tenant-defined worker Prompt XML Alias. A copied value for this alias is always replaced by worker_identifier. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get W-2 Report

**Slug:** `WORKDAY_RAAS_GET_W2_REPORT`

Retrieve W-2 records from a tenant-defined Workday customreport2 or systemreport2 report using controlled company, one or more tax-year, and optional worker prompts. Each requested tax year is fetched separately and returned both per year and as one ordered aggregate. A worker prompt alias can clear a copied worker filter without replacement.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `company` | string | Yes | Company WID: exactly 32 lowercase hexadecimal characters. |
| `tax_year` | string | Yes | One tax-year WID or a list of 1-10 distinct tax-year WIDs to retrieve in order. Every value must be exactly 32 lowercase hexadecimal characters, not a four-digit calendar year. The plural tax_years spelling is also accepted for list input. |
| `report_url` | string | Yes | Full HTTPS JSON RaaS report URL copied from the tenant's W-2 report definition. Authentication must not be embedded in it. |
| `worker_identifiers` | array | No | Optional 1-100 W-2 result-specific generated worker identifier values, each exactly 32 lowercase hexadecimal characters; these are not Worker object WIDs. Requires worker_prompt_alias when supplied. |
| `worker_prompt_alias` | string | No | Optional exact tenant-defined worker Prompt XML Alias including !WID. Provide it with worker_identifiers to replace that worker filter, or by itself to remove that copied filter from report_url without replacement. |
| `company_prompt_alias` | string | Yes | Exact Label for Prompt XML Alias configured for the company prompt; include !WID only when it is part of that instance prompt. |
| `tax_year_prompt_alias` | string | Yes | Exact Label for Prompt XML Alias configured for the tax-year prompt; include !WID only when configured by the report. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Run RaaS Report

**Slug:** `WORKDAY_RAAS_RUN_RAAS_REPORT`

Run a Workday customreport2 or systemreport2 report from its full tenant URL and return its dynamic JSON output, using an optional map of exact Prompt XML Alias names to values.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prompts` | object | No | Optional map of exact Prompt XML Alias names to values, for example {"Company!WID": "0123456789abcdef0123456789abcdef"}. Append !WID to an alias only when required by the report prompt, and use Workday's !-joined value representation for a multi-instance prompt. |
| `report_url` | string | Yes | Full HTTPS Workday RaaS report URL copied from the report definition. It may include non-credential prompt query values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |