---
availability: INSTALLABLE
description: A plugin that enables managers to view their direct reports.
installation_asset_uuid: a1221e29-47ae-4288-8ee2-1c05cd956cd1
name: Look Up Direct Reports
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%22I+want+to+view+details+of+my+team.%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%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ESearching+%3Cb%3ESAP+SuccessFactors%3C%2Fb%3E+for+your+team+members%2C+including+your+direct+reports+and+those+under+sub-managers.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EI+can+help+you+view+your+team+members.+Would+you+like+to+see+only+your+direct+reports%2C+or+your+entire+team+hierarchy%2C+including+those+reporting+to+your+sub-managers%3F%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Show+me+my+entire+team+hierarchy.%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%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ERetrieving+your+full+team+hierarchy+from+%3Cb%3ESAP+SuccessFactors%3C%2Fb%3E.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ENo+problem%21+Here%27s+your+entire+team+hierarchy%3A%3C%2Fp%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EAlex+Johnson%3C%2Fb%3E+-+%3Ci%3ESenior+Software+Engineer%3C%2Fi%3E%3C%2Fli%3E%3Cli%3E%3Cb%3EMaria+Garcia%3C%2Fb%3E+-+%3Ci%3EProduct+Manager%3C%2Fi%3E%3Cul%3E%3Cli%3E%3Cb%3EJohn+Smith%3C%2Fb%3E+-+%3Ci%3ESoftware+Engineer%3C%2Fi%3E%3C%2Fli%3E%3C%2Ful%3E%3C%2Fli%3E%3Cli%3E%3Cb%3EDavid+Lee%3C%2Fb%3E+-+%3Ci%3EQuality+Assurance+Lead%3C%2Fi%3E%3Cul%3E%3Cli%3E%3Cb%3ESarah+Chen%3C%2Fb%3E+-+%3Ci%3EQA+Tester%3C%2Fi%3E%3C%2Fli%3E%3Cli%3E%3Cb%3EMichael+Brown%3C%2Fb%3E+-+%3Ci%3EQA+Engineer%3C%2Fi%3E%3C%2Fli%3E%3C%2Ful%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EPlease+tell+me+the+name+of+the+employee+you%27d+like+to+see+more+details+for.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Show+me+John+Smith%27s+details.%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%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ERetrieving+detailed+profile+information+for+John+Smith+from+%3Cb%3ESAP+SuccessFactors%3C%2Fb%3E.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+details+for+%3Cstrong%3EJohn+Smith%3C%2Fstrong%3E%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3E%3Cstrong%3EStatus%3C%2Fstrong%3E%3A+Active%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EEmployee+Name%3C%2Fstrong%3E%3A+John+Smith%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EEmail%3C%2Fstrong%3E%3A+john.smith%40example.com%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EDepartment%3C%2Fstrong%3E%3A+Engineering%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EJob+Title%3C%2Fstrong%3E%3A+Software+Engineer%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EHire+Date%3C%2Fstrong%3E%3A+2022-01-20%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EStart+Date%3C%2Fstrong%3E%3A+2022-01-20%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EFTE%3C%2Fstrong%3E%3A+Yes%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EPhone+Number%3C%2Fstrong%3E%3A+%2B1+%28555%29+987-6543%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3ELocation%3C%2Fstrong%3E%3A+San+Francisco+Office%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EManager%3C%2Fstrong%3E%3A+Maria+Garcia%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22John+Smith%22%7D%5D%7D%5D%7D%5D%7D
solution_tags:
- HR - Employee Records
systems:
- sap-success-factors
---
## Introduction
The **“Look Up Direct Reports”** plugin allows managers to quickly view their direct reports in SAP SuccessFactors via the Moveworks AI Assistant, eliminating the need to manually navigate organizational charts. With this automation, managers can efficiently access team information and direct report details without delays.
This guide will help you install and configure the plugin in **Agent Studio** within 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%22I+want+to+view+details+of+my+team.%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%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ESearching+%3Cb%3ESAP+SuccessFactors%3C%2Fb%3E+for+your+team+members%2C+including+your+direct+reports+and+those+under+sub-managers.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EI+can+help+you+view+your+team+members.+Would+you+like+to+see+only+your+direct+reports%2C+or+your+entire+team+hierarchy%2C+including+those+reporting+to+your+sub-managers%3F%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Show+me+my+entire+team+hierarchy.%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%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ERetrieving+your+full+team+hierarchy+from+%3Cb%3ESAP+SuccessFactors%3C%2Fb%3E.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ENo+problem%21+Here%27s+your+entire+team+hierarchy%3A%3C%2Fp%3E%3Cul+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3E%3Cli%3E%3Cb%3EAlex+Johnson%3C%2Fb%3E+-+%3Ci%3ESenior+Software+Engineer%3C%2Fi%3E%3C%2Fli%3E%3Cli%3E%3Cb%3EMaria+Garcia%3C%2Fb%3E+-+%3Ci%3EProduct+Manager%3C%2Fi%3E%3Cul%3E%3Cli%3E%3Cb%3EJohn+Smith%3C%2Fb%3E+-+%3Ci%3ESoftware+Engineer%3C%2Fi%3E%3C%2Fli%3E%3C%2Ful%3E%3C%2Fli%3E%3Cli%3E%3Cb%3EDavid+Lee%3C%2Fb%3E+-+%3Ci%3EQuality+Assurance+Lead%3C%2Fi%3E%3Cul%3E%3Cli%3E%3Cb%3ESarah+Chen%3C%2Fb%3E+-+%3Ci%3EQA+Tester%3C%2Fi%3E%3C%2Fli%3E%3Cli%3E%3Cb%3EMichael+Brown%3C%2Fb%3E+-+%3Ci%3EQA+Engineer%3C%2Fi%3E%3C%2Fli%3E%3C%2Ful%3E%3C%2Fli%3E%3C%2Ful%3E%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3EPlease+tell+me+the+name+of+the+employee+you%27d+like+to+see+more+details+for.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22role%22%3A%22user%22%2C%22parts%22%3A%5B%7B%22richText%22%3A%22Show+me+John+Smith%27s+details.%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%22%3Cp+xmlns%3D%5C%22http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml%5C%22%3ERetrieving+detailed+profile+information+for+John+Smith+from+%3Cb%3ESAP+SuccessFactors%3C%2Fb%3E.%3C%2Fp%3E%22%7D%5D%7D%2C%7B%22richText%22%3A%22%3Cp%3EHere+are+the+details+for+%3Cstrong%3EJohn+Smith%3C%2Fstrong%3E%3A%3C%2Fp%3E%3Cul%3E%3Cli%3E%3Cp%3E%3Cstrong%3EStatus%3C%2Fstrong%3E%3A+Active%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EEmployee+Name%3C%2Fstrong%3E%3A+John+Smith%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EEmail%3C%2Fstrong%3E%3A+john.smith%40example.com%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EDepartment%3C%2Fstrong%3E%3A+Engineering%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EJob+Title%3C%2Fstrong%3E%3A+Software+Engineer%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EHire+Date%3C%2Fstrong%3E%3A+2022-01-20%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EStart+Date%3C%2Fstrong%3E%3A+2022-01-20%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EFTE%3C%2Fstrong%3E%3A+Yes%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EPhone+Number%3C%2Fstrong%3E%3A+%2B1+%28555%29+987-6543%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3ELocation%3C%2Fstrong%3E%3A+San+Francisco+Office%3C%2Fp%3E%3C%2Fli%3E%3Cli%3E%3Cp%3E%3Cstrong%3EManager%3C%2Fstrong%3E%3A+Maria+Garcia%3C%2Fp%3E%3C%2Fli%3E%3C%2Ful%3E%22%7D%2C%7B%22citations%22%3A%5B%7B%22connectorName%22%3A%22sap-successfactors%22%2C%22citationTitle%22%3A%22John+Smith%22%7D%5D%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 **Lookup Direct Reports** plugin and complete the setup efficiently.
For this plugin, ensure the SAP SuccessFactors integration user has the following permissions:
**Required Scopes:**
- `View` access to the **User** entity
- `View` access to the **DirectReports** entity (expanded from User)
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 Direct Reports of a Manager**
```bash
curl --request GET \
--location 'https://<YOUR_INSTANCE>/odata/vX/User?$filter=email eq '{{email}}'&$expand=directReports&$select=userId,email,displayName,directReports/userId,directReports/displayName,directReports/email,directReports/title,directReports/department,directReports/location,directReports/businessPhone,directReports/city,directReports/hireDate,directReports/employeeClass,directReports/status' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Accept: application/json'
```
**Query Parameters:**
- `$filter` (string) – Filter user by property values - email eq '{{email}}'
- `$expand` (string) – Expand related entities - directReports
- `$select` (string) – Select properties to be returned - userId, email, displayName of the manager, and for direct reports: userId, displayName, email, title, department, location, businessPhone, city, hireDate, employeeClass, status.