workday-view-internal-job-postings implementation guide

---
availability: INSTALLABLE
description: A plugin that allows employees to see what current internal postings
  are available.
installation_asset_uuid: b8b30db1-d7d8-403d-8f27-6b9be271127b
name: View Internal Job Postings
purple_chat_link: https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Show+me+all+internal+job+postings+in+the+Sales+department+on+Workday.%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Filtering+internal+job+postings+in+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EWorkday%3C%2Fb%3E+by+department%3A+Sales.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Here+are+the+internal+job+postings+currently+available+in+the+Sales+department%3A%22%7D%2C%7B%22richText%22%3A%22%3Ch3+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E1.+%3Cb%3ERegional+Sales+Manager%3C%2Fb%3E%3C%2Fh3%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EJobTitle%3A%3C%2Fb%3E+Regional+Sales+Manager%3C%2Fli%3E%3Cli%3E%3Cb%3EJobPostingID%3A%3C%2Fb%3E+JOB_POSTING-11-918%3C%2Fli%3E%3Cli%3E%3Cb%3EJobDescription%3A%3C%2Fb%3E+Manages+regional+sales+strategy+and+execution+in+Asia+Pacific.%3C%2Fli%3E%3Cli%3E%3Cb%3EJobLocation%3A%3C%2Fb%3E+Hong_Kong%3C%2Fli%3E%3Cli%3E%3Cb%3EGroup%3A%3C%2Fb%3E+Sales%3C%2Fli%3E%3Cli%3E%3Cb%3ETimeType%3A%3C%2Fb%3E+Full_time%3C%2Fli%3E%3Cli%3E%3Cb%3EJobType%3A%3C%2Fb%3E+Regular%3C%2Fli%3E%3Cli%3E%3Cb%3EOrganization%3A%3C%2Fb%3E+SUPERVISORY_Field_Sales_Asia_Pac_Group%3C%2Fli%3E%3Cli%3E%3Cb%3EPostedDate%3A%3C%2Fb%3E+2021-02-26%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22workday%22%2C%22citationTitle%22%3A%22RequisitionID%3A+R-00230%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Ch3+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E2.+%3Cb%3ESales+Operations+Analyst%3C%2Fb%3E%3C%2Fh3%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EJobTitle%3A%3C%2Fb%3E+Sales+Operations+Analyst%3C%2Fli%3E%3Cli%3E%3Cb%3EJobPostingID%3A%3C%2Fb%3E+JOB_POSTING-11-919%3C%2Fli%3E%3Cli%3E%3Cb%3EJobDescription%3A%3C%2Fb%3E+Supports+sales+planning%2C+reporting%2C+and+performance+analytics.%3C%2Fli%3E%3Cli%3E%3Cb%3EJobLocation%3A%3C%2Fb%3E+Singapore%3C%2Fli%3E%3Cli%3E%3Cb%3EGroup%3A%3C%2Fb%3E+Sales%3C%2Fli%3E%3Cli%3E%3Cb%3ETimeType%3A%3C%2Fb%3E+Full_time%3C%2Fli%3E%3Cli%3E%3Cb%3EJobType%3A%3C%2Fb%3E+Regular%3C%2Fli%3E%3Cli%3E%3Cb%3EOrganization%3A%3C%2Fb%3E+SUPERVISORY_Field_Sales_APAC%3C%2Fli%3E%3Cli%3E%3Cb%3EPostedDate%3A%3C%2Fb%3E+2021-03-01%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22workday%22%2C%22citationTitle%22%3A%22RequisitionID%3A+R-00231%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EThere+may+be+more+jobs+in+Sales.+What+would+you+like+to+do+next%3F%3C%2Fp%3E%22%7D%5D%7D%5D%7D
solution_tags:
- HR - Other
- HR - Recruiting & Talent
systems:
- workday
---

## Introduction

The **“View Internal Job Postings”** plugin allows employees to easily discover and explore open job opportunities within their organization directly from **Workday** using the Moveworks AI Assistant. This eliminates the need to manually navigate through Workday’s job postings, making it simpler for users to stay informed about career opportunities and apply for relevant roles in real time.

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

### Agent Design

This [purple chat](https://marketplace.moveworks.com/purple-chat?conversation=%7B%22messages%22%3A%5B%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Show+me+all+internal+job+postings+in+the+Sales+department+on+Workday.%22%7D%5D%7D%2C%7B%22role%22%3A%22assistant%22%2C%22parts%22%3A%5B%7B%22reasoningSteps%22%3A%5B%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Filtering+internal+job+postings+in+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EWorkday%3C%2Fb%3E+by+department%3A+Sales.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Here+are+the+internal+job+postings+currently+available+in+the+Sales+department%3A%22%7D%2C%7B%22richText%22%3A%22%3Ch3+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E1.+%3Cb%3ERegional+Sales+Manager%3C%2Fb%3E%3C%2Fh3%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EJobTitle%3A%3C%2Fb%3E+Regional+Sales+Manager%3C%2Fli%3E%3Cli%3E%3Cb%3EJobPostingID%3A%3C%2Fb%3E+JOB_POSTING-11-918%3C%2Fli%3E%3Cli%3E%3Cb%3EJobDescription%3A%3C%2Fb%3E+Manages+regional+sales+strategy+and+execution+in+Asia+Pacific.%3C%2Fli%3E%3Cli%3E%3Cb%3EJobLocation%3A%3C%2Fb%3E+Hong_Kong%3C%2Fli%3E%3Cli%3E%3Cb%3EGroup%3A%3C%2Fb%3E+Sales%3C%2Fli%3E%3Cli%3E%3Cb%3ETimeType%3A%3C%2Fb%3E+Full_time%3C%2Fli%3E%3Cli%3E%3Cb%3EJobType%3A%3C%2Fb%3E+Regular%3C%2Fli%3E%3Cli%3E%3Cb%3EOrganization%3A%3C%2Fb%3E+SUPERVISORY_Field_Sales_Asia_Pac_Group%3C%2Fli%3E%3Cli%3E%3Cb%3EPostedDate%3A%3C%2Fb%3E+2021-02-26%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22workday%22%2C%22citationTitle%22%3A%22RequisitionID%3A+R-00230%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Ch3+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E2.+%3Cb%3ESales+Operations+Analyst%3C%2Fb%3E%3C%2Fh3%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EJobTitle%3A%3C%2Fb%3E+Sales+Operations+Analyst%3C%2Fli%3E%3Cli%3E%3Cb%3EJobPostingID%3A%3C%2Fb%3E+JOB_POSTING-11-919%3C%2Fli%3E%3Cli%3E%3Cb%3EJobDescription%3A%3C%2Fb%3E+Supports+sales+planning%2C+reporting%2C+and+performance+analytics.%3C%2Fli%3E%3Cli%3E%3Cb%3EJobLocation%3A%3C%2Fb%3E+Singapore%3C%2Fli%3E%3Cli%3E%3Cb%3EGroup%3A%3C%2Fb%3E+Sales%3C%2Fli%3E%3Cli%3E%3Cb%3ETimeType%3A%3C%2Fb%3E+Full_time%3C%2Fli%3E%3Cli%3E%3Cb%3EJobType%3A%3C%2Fb%3E+Regular%3C%2Fli%3E%3Cli%3E%3Cb%3EOrganization%3A%3C%2Fb%3E+SUPERVISORY_Field_Sales_APAC%3C%2Fli%3E%3Cli%3E%3Cb%3EPostedDate%3A%3C%2Fb%3E+2021-03-01%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22workday%22%2C%22citationTitle%22%3A%22RequisitionID%3A+R-00231%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EThere+may+be+more+jobs+in+Sales.+What+would+you+like+to+do+next%3F%3C%2Fp%3E%22%7D%5D%7D%5D%7D) shows the experience we are going to build.

## Installation Steps

While you can create a connector during plugin installation, we recommend setting up the connector in **Agent Studio** beforehand to simplify the process. Please follow our [**Workday Connector Guide**](https://developer.moveworks.com/marketplace/package/?id=workday&hist=home%2Cbrws#how-to-implement) for detailed instructions. Once completed, proceed to install the plugin and complete the setup efficiently.

For this plugin, ensure the Workday integration system user has the following permissions:

**Required Permissions:**

- `View access` to Job Requisitions
- `View access` to Internal Job Postings

**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 Internal Job Postings**

```bash
curl --location 'https://<API_SERVER_DOMAIN>/ccx/service/<TENANT>/Recruiting/v44.1' \
--header 'Content-Type: text/xml' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data-raw '<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"
                xmlns:wd="urn:com.workday/bsvc">
    <env:Header/>
    <env:Body>
      <wd:Get_Job_Postings_Request wd:version="v44.1">
        <wd:Request_Criteria>
          <wd:Job_Posting_Site_Reference>
            <wd:ID wd:type="Job_Posting_Site_ID">INT</wd:ID>
          </wd:Job_Posting_Site_Reference>
          <wd:Show_Only_Active_Job_Postings>true</wd:Show_Only_Active_Job_Postings>
        </wd:Request_Criteria>  
        <wd:Response_Filter>
          <wd:Page>1</wd:Page>
          <wd:Count>30</wd:Count>
        </wd:Response_Filter>       
        <wd:Response_Group>
          <wd:Include_Reference>true</wd:Include_Reference>
        </wd:Response_Group>
      </wd:Get_Job_Postings_Request>
    </env:Body>
  </env:Envelope>'
```

**Request Body Parameters:**

- `Job_Posting_Site_ID` – Use `INT` to fetch internal job postings.
- `Show_Only_Active_Job_Postings` – Set to `true` to return only active jobs.
- `Page` – Page number for paginated results.
- `Count` – Number of job postings returned per page.
- `Include_Reference` – Set to `true` to include reference details in the response