---
availability: INSTALLABLE
description: A plugin that allows employees to securely access and retrieve their
payslips.
installation_asset_uuid: a26d1906-ef7f-4eb5-8541-f91df83c94aa
name: View Payslips
purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22can+you+fetch+my+payslip+for+year+2022+%3F%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Fetching+payslips+for+the+year+2022+from+Workday...%22%2C%22status%22%3A%22pending%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+your+payslips+for+the%3Cstrong%3E+year+2022%3C%2Fstrong%3E%3A%3C%2Fp%3E%22%7D%2C%7B%22richText%22%3A%22%3Col%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EDecember+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C613.22%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ENovember+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C769.41%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EOctober+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C769.40%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ESeptember+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C639.33%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EAugust+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C477.24%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EJuly+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C441.79%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EJune+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C441.78%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EMay+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C441.78%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn%3C%2Fol%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22View+Payslip+December+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+November+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+October+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+September+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+August+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+July+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+June+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+May+2022%22%2C%22connectorName%22%3A%22workday%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D
solution_tags:
- Finance - Other
- Finance - Payroll
- HR - Other
systems:
- workday
---
## Introduction
The **“View Payslips”** plugin allows employees to securely access their payslips for any pay period directly through the Moveworks AI Assistant. This provides a convenient and efficient way to review salary details and net pay without navigating through Workday manually.
This guide will walk you through installing and configuring the plugin in **Agent Studio** in just a few minutes. Let’s get started!
## **Prerequisites**
- Access to Agent Studio
## **What are we building?**
### Agent Design
This [purple chat](https://developer.moveworks.com/creator-studio/developer-tools/purple-chat/?conversation=%7B%22startTimestamp%22%3A%2211%3A43+AM%22%2C%22messages%22%3A%5B%7B%22parts%22%3A%5B%7B%22richText%22%3A%22can+you+fetch+my+payslip+for+year+2022+%3F%22%7D%5D%2C%22role%22%3A%22user%22%7D%2C%7B%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22richText%22%3A%22Fetching+payslips+for+the+year+2022+from+Workday...%22%2C%22status%22%3A%22pending%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+your+payslips+for+the%3Cstrong%3E+year+2022%3C%2Fstrong%3E%3A%3C%2Fp%3E%22%7D%2C%7B%22richText%22%3A%22%3Col%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EDecember+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C613.22%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ENovember+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C769.41%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EOctober+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C769.40%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3ESeptember+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2412%2C639.33%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EAugust+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C477.24%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EJuly+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C441.79%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EJune+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C441.78%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn++%3Cli%3E%5Cn++++%3Cb%3EMay+2022%3C%2Fb%3E%3A%5Cn++++%3Cul%3E%5Cn++++++%3Cli%3EGross%3A+%2418%2C603%3C%2Fli%3E%5Cn++++++%3Cli%3ENet%3A+%2411%2C441.78%3C%2Fli%3E%5Cn++++%3C%2Ful%3E%5Cn++%3C%2Fli%3E%5Cn%3C%2Fol%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22citationTitle%22%3A%22View+Payslip+December+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+November+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+October+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+September+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+August+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+July+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+June+2022%22%2C%22connectorName%22%3A%22workday%22%7D%2C%7B%22citationTitle%22%3A%22View+Payslip+May+2022%22%2C%22connectorName%22%3A%22workday%22%7D%5D%7D%5D%2C%22role%22%3A%22assistant%22%7D%5D%7D) shows the experience we are going to build.
## **Installation Steps**
We recommend creating the connector for **Workday** first, prior to installing this plugin. Please follow the [Workday Connector](https://developer.moveworks.com/marketplace/package/?id=workday&hist=home%2Cbrws#how-to-implement) guide to set up the connector.
For this plugin, ensure the Workday integration system user has the following permissions:
**Required Permissions:**
- `View and Get access` to Worker Data: Payroll (Payslips)
- `Get access` to Reports: Pay Calculation Results for Worker
**Tenant Configuration:**
All Workday API endpoints in this plugin use **TENANT** as a placeholder. After installation, replace **TENANT** in the action definitions with your actual Workday tenant name.
To find your tenant name:
- Log into Workday.
- Check the URL in your browser — the tenant name appears after `workday.com/`, e.g.: [https://impl.workday.com/**your_tenant**/...](https://impl.workday.com/**your_tenant**/...)
Make sure to update this across all actions that reference the Workday API.
After configuring the connector and updating your tenant, refer to our [plugin installation documentation](https://help.moveworks.com/docs/ai-agent-marketplace-installation) for more details on completing the setup.
## **Appendix**
### **API#1: Get Worker Details by Email**
```bash
curl --location 'https://<API_SERVER_DOMAIN>/ccx/api/wql/v1/<TENANT>/data' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT workdayID, fullName, businessTitle, email_PrimaryWorkOrPrimaryHome as email, employeeID FROM allWorkers WHERE email_PrimaryWorkOrPrimaryHome = %27{{email}}%27"
}'
```
**Request Body Parameters:**
- `email` (string) – The primary home email address of the worker used to look up their Workday ID
### **API #2: Fetch Payslips for Worker**
```bash
curl --location 'https://<API_SERVER_DOMAIN>/ccx/api/common/v1/<TENANT>/workers/{WORKER_ID}/paySlips?limit=48&offset=0' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json'
```
**Query Parameters:**
- `WORKER_ID` (string) – To retrieve pay slips for a specific worker ID