---
availability: INSTALLABLE
description: A plugin that allows recruiters to view candidates linked to a job requisition.
installation_asset_uuid: 060d552d-f371-486d-a189-d2778ce19f4b
name: Look Up Candidates for a Job Requisition
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%22Look+up+candidates+for+a+requisition%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%22Understanding+intent+to+look+up+candidates+by+requisition.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Prompting+user+for+job+opening+details.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Please+specify+the+job+opening+or+title+for+which+you%27d+like+to+see+candidates.%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Candidates+who+have+applied+for+Business+Consultant+position%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%22Searching+for+requisitions+matching+%27Business+Consultant%27.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Presenting+matching+requisitions+for+user+selection.%22%7D%5D%7D%2C%7B%22richText%22%3A%22I+found+3+job+requisitions+matching+%27Business+Consultant%27.+Please+select+the+one+you%27re+interested+in%3A%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E1.+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EBusiness+Consultant%3C%2Fb%3E+-+Req+%23101%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E2.+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ESenior+Business+Consultant%3C%2Fb%3E+-+Req+%23102%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E3.+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EJunior+Business+Consultant%3C%2Fb%3E+-+Req+%23103%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22Business+Consultant+-+Req+%23101+%28Open%29%22%7D%2C%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22Senior+Business+Consultant+-+Req+%23102+%28Open%29%22%7D%2C%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22Junior+Business+Consultant+-+Req+%23103+%28Pending+Approval%29%22%7D%5D%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22The+3rd+one%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%22User+selected+%27Junior+Business+Consultant+-+Req+%23103%27.%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Retrieving+candidate+details+for+Req+%23103+from+SAP+SuccessFactors.%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+candidates+for+%3Cstrong%3EJunior+Business+Consultant+-+Req+%23103%3C%2Fstrong%3E%3A%3C%2Fp%3E%3Cp%3E%3Cstrong%3EJane+Doe%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EApplication+status%3A+Interviewing%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECurrent+disposition%3A+Interview+Scheduled%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESource%3A+LinkedIn%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECandidate+ID%3A+CND-456%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEmail+address%3A+jane.doe%40example.com%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EPhone+number%28s%29%3A+%2B1+%28555%29+123-4567%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAddress%3A+123+Main+St%2C+Anytown%2C+CA+90210%2C+USA%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EResume%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3EJaneDoe_Resume.pdf%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECover+letter%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3EJaneDoe_CoverLetter.pdf%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EWork+experience%3A+Software+Engineer+at+TechCorp+%282020-Present%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEducation+details%3A+BS+in+Computer+Science%2C+University+of+California+%282020%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESkills+%2F+certifications%3A+Java%2C+Python%2C+AWS%2C+PMP%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ELinkedIn+%2F+social+profiles%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3Elinkedin.com%2Fin%2Fjanedoe%3C%2Fa%3E%3C%2Fp%3E%3Cp%3E%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EMark+Johnson%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EApplication+status%3A+New+Application%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECurrent+disposition%3A+Under+Review%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESource%3A+Company+Website%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECandidate+ID%3A+CND-789%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEmail+address%3A+mark.j%40example.com%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EPhone+number%28s%29%3A+%2B1+%28555%29+987-6543%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAddress%3A+456+Oak+Ave%2C+Big+City%2C+NY+10001%2C+USA%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EResume%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3EMarkJohnson_Resume.pdf%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECover+letter%3A+N%2FA%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EWork+experience%3A+Junior+Developer+at+StartupX+%282021-Present%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEducation+details%3A+BA+in+Computer+Engineering%2C+State+University+%282021%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESkills+%2F+certifications%3A+C%23%2C+SQL%2C+Azure%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ELinkedIn+%2F+social+profiles%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3Elinkedin.com%2Fin%2Fmarkjohnson%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%5D%7D%5D%7D
solution_tags:
- HR - Recruiting & Talent
systems:
- sap-success-factors
---
## Introduction
The '**Look Up Candidates for Job Requisition**' plugin allows recruiters to view candidates linked to a job requisition in SAP SuccessFactors through the Moveworks AI Assistant, eliminating the need to navigate through recruiting portals manually. With this automation, recruiters can access candidate information for efficient hiring without delays.
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://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%22Look+up+candidates+for+a+requisition%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%22Understanding+intent+to+look+up+candidates+by+requisition.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Prompting+user+for+job+opening+details.%22%7D%5D%7D%2C%7B%22richText%22%3A%22Please+specify+the+job+opening+or+title+for+which+you%27d+like+to+see+candidates.%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Candidates+who+have+applied+for+Business+Consultant+position%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%22Searching+for+requisitions+matching+%27Business+Consultant%27.%22%7D%2C%7B%22status%22%3A%22pending%22%2C%22richText%22%3A%22Presenting+matching+requisitions+for+user+selection.%22%7D%5D%7D%2C%7B%22richText%22%3A%22I+found+3+job+requisitions+matching+%27Business+Consultant%27.+Please+select+the+one+you%27re+interested+in%3A%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E1.+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EBusiness+Consultant%3C%2Fb%3E+-+Req+%23101%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E2.+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ESenior+Business+Consultant%3C%2Fb%3E+-+Req+%23102%3Cbr+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22+%2F%3E3.+%3Cb+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EJunior+Business+Consultant%3C%2Fb%3E+-+Req+%23103%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22Business+Consultant+-+Req+%23101+%28Open%29%22%7D%2C%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22Senior+Business+Consultant+-+Req+%23102+%28Open%29%22%7D%2C%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22Junior+Business+Consultant+-+Req+%23103+%28Pending+Approval%29%22%7D%5D%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22The+3rd+one%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%22User+selected+%27Junior+Business+Consultant+-+Req+%23103%27.%22%7D%2C%7B%22status%22%3A%22success%22%2C%22richText%22%3A%22Retrieving+candidate+details+for+Req+%23103+from+SAP+SuccessFactors.%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+candidates+for+%3Cstrong%3EJunior+Business+Consultant+-+Req+%23103%3C%2Fstrong%3E%3A%3C%2Fp%3E%3Cp%3E%3Cstrong%3EJane+Doe%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EApplication+status%3A+Interviewing%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECurrent+disposition%3A+Interview+Scheduled%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESource%3A+LinkedIn%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECandidate+ID%3A+CND-456%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEmail+address%3A+jane.doe%40example.com%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EPhone+number%28s%29%3A+%2B1+%28555%29+123-4567%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAddress%3A+123+Main+St%2C+Anytown%2C+CA+90210%2C+USA%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EResume%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3EJaneDoe_Resume.pdf%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECover+letter%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3EJaneDoe_CoverLetter.pdf%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EWork+experience%3A+Software+Engineer+at+TechCorp+%282020-Present%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEducation+details%3A+BS+in+Computer+Science%2C+University+of+California+%282020%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESkills+%2F+certifications%3A+Java%2C+Python%2C+AWS%2C+PMP%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ELinkedIn+%2F+social+profiles%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3Elinkedin.com%2Fin%2Fjanedoe%3C%2Fa%3E%3C%2Fp%3E%3Cp%3E%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp%3E%3Cstrong%3EMark+Johnson%3C%2Fstrong%3E%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3EApplication+status%3A+New+Application%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECurrent+disposition%3A+Under+Review%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESource%3A+Company+Website%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECandidate+ID%3A+CND-789%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEmail+address%3A+mark.j%40example.com%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EPhone+number%28s%29%3A+%2B1+%28555%29+987-6543%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EAddress%3A+456+Oak+Ave%2C+Big+City%2C+NY+10001%2C+USA%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EResume%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3EMarkJohnson_Resume.pdf%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ECover+letter%3A+N%2FA%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EWork+experience%3A+Junior+Developer+at+StartupX+%282021-Present%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3EEducation+details%3A+BA+in+Computer+Engineering%2C+State+University+%282021%29%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ESkills+%2F+certifications%3A+C%23%2C+SQL%2C+Azure%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3ELinkedIn+%2F+social+profiles%3A+%3Ca+target%3D%5C%22_blank%5C%22+rel%3D%5C%22noopener+noreferrer+nofollow%5C%22+class%3D%5C%22editor-link%5C%22+href%3D%5C%22%23%5C%22%3Elinkedin.com%2Fin%2Fmarkjohnson%3C%2Fa%3E%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%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 streamline the process. Please follow our [**SAP SuccessFactors Connector**](https://marketplace.moveworks.com/connectors/sap-success-factors#how-to-implement) guide for detailed instructions. Once completed, proceed to install the **Look Up Candidates for Job Requisition** plugin and complete the setup efficiently.
For this plugin, ensure the SAP SuccessFactors integration recruiters have the following permissions:
**Required Scopes:**
- `View` access to the **JobRequisition** entity
- `View` access to the **JobApplication** entity
After configuring the connector, 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 Job Requisitions By Candidate Name
```bash
curl --location 'https://<YOUR_INSTANCE>/odata/v2/JobRequisition?%24expand=jobReqLocale%2CjobReqFwdCandidates%2Fcandidate%2Crecruiter&%24filter=(recruiter%2Femail%20eq%20%27{{EMAIL}}%27)%20and%20internalStatus%20eq%20%27Approved%27%20and%20substringof(%27{{CANDIDATE_NAME}}%27%2C%20jobReqFwdCandidates%2Fcandidate%2FfirstName)' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```
**Query Parameters:**
- `EMAIL` (string) – Used to retrieve the Job requisitions by particular Recruiter
- `CANDIDATE_NAME` (string) - Used to retrieve by candidate name.
### API#2: Get Job Requisitions By Job Title
```bash
curl --location 'https://<YOUR_INSTANCE>/odata/v2/JobRequisition?%24expand=recruiter%2CjobReqLocale&%24filter=recruiter%2Femail%20eq%20%27{{EMAIL}}%27%20and%20substringof(%27{{JOB_TITLE}}%27%2C%20jobReqLocale%2FjobTitle)%20and%20internalStatus%20eq%20%27Approved%27&%24select=jobReqId%2CjobReqLocale%2FjobTitle%2CinternalStatus%2Cdeleted' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```
**Query Parameters:**
- `EMAIL` (string) – Used to retrieve the Job requisitions by particular Recruiter
- `JOB_TITLE` (string) - Used to retrieve by Job title.
### API#3: Get Candidate Details By Requisition ID
```bash
curl --location 'https://<YOUR_INSTANCE>/odata/v2/JobApplication?%24expand=education%2CjobApplicationInterview%2CoutsideWorkExperience%2Cstate%2CinsideWorkExperience%2CjobAppStatus%2CveteranStatus%2Csalutation&%24filter=jobReqId%20eq%20%27{{REQUISITION_ID}}%27%20and%20jobRequisition%2Frecruiter%2Femail%20eq%20%27{{EMAIL}}%27&%24select=applicationId%2Cstatus%2Caddress%2Ccity%2CcellPhone%2CnonApplicantStatus%2CfirstName%2CmiddleName%2ClastName%2CcontactEmail%2CcandidateId%2CdataSource%2CoutsideWorkExperience%2FstartDate%2CoutsideWorkExperience%2FstartTitle%2CoutsideWorkExperience%2FendDate%2CoutsideWorkExperience%2FlastModifiedDateTime%2CinsideWorkExperience%2Ceducation%2Fschool%2CjobApplicationInterview%2CjobAppStatus%2FappStatusName' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'
```
**Query Parameters:**
- `EMAIL` (string) - Used to retrieve the Job requisitions by particular Recruiter
- `REQUISITION_ID` (string) – Used to retrieve the candidate details