Setting up the Workday Connector app
Account owners and administrators can efficiently integrate and configure Workday credentials, perform initial setup procedures, and implement Workday within the Workforce Management integration interface. This integration enables agents and supervisors to submit and authorize leave requests, which are subsequently reflected in Workday upon approval.
Requirements for using the Workday Connector app
- Account owner or administrator privileges
- Zoom Workforce Management license
- Refresh token with appropriate permissions generated and accessible from Workday
Important: Currently, the system manages the Time Off leave category. Zoom does not provide technical support for the Workday. If you need help, contact Workday or your IT admin that manages the application.
How to access the Workday Connector app
You can access Workday for Workforce Management marketplace connector apps from the Zoom App Marketplace listing page.
- Sign in to the Zoom App Marketplace using admin credentials.
- Use the search box to find the Workday for WFM Connector app.
- Click on the app's icon or name to access it.
- Click Add to create the connector.
How to create an Integration System User (ISU)
You can use an existing user, but it is recommended to create a dedicated Integration System User in Workday.
- Sign in to Workday.
- In the search bar, enter Integration System User (ISU).
- Click Create ISU and complete the required details:
- Click OK.
How to create security group to be used in your integration
- Sign in to Workday.
- In the search bar, enter Security Group.
- Select Create Security Group.
- Next to Type of Tenanted Security Group, select Integration System Security Group (Unconstrained).
- Enter a name for your ISSG (for example, ISSG_WFM) and click OK.
- Assign the Integration System User created in previous section (ISU_WFM) to this security group.
How to add permissions to ISSG for APIs
- Sign in to Workday.
- Search for Integration System Security Group (Unconstrained) and open it.
- Click the ellipsis icon
next to the group and select Security Group. - Click Maintain Domain Permissions for Security Group.
- Add the following domain security policies:
- View Access:
- Worker Data: Public Worker Reports
- Worker Data: Time Off (Time Off Balances)
- Put Access:
- Worker Data: Time Off (Time Off)
- Get Access:
- Integration Build
- Worker Data: Public Worker Reports
- Click OK.
Configure business process permissions
For Request Time Off business process:
- Search for bp: Request Time Off.
- Click the ellipsis icon
next to the business process definition. - Select Business Process Policy then Edit.
- Add ISSG_WFM to:
- Who Can Start the Business Process
- Who Can Do Actions on Entire Business Process
For Correct Time Off business process:
- Search for bp: Correct Time Off.
- Click the ellipsis icon
next to the business process definition. - Select Business Process Policy then Edit.
- Add ISSG_WFM to:
- Who Can Start the Business Process
- Who Can Do Actions on Entire Business Process
How to activate pending security policy changes
This step ensures that all permissions assigned above take effect.
- Sign in to Workday.
- Search for Activate Pending Security Policy Changes and select it.
- Review your changes, check Confirm, and click Submit.
After this step, ISSG_WFM will have the assigned permissions.
How to generate a Refresh Token for API Integration
- Sign in to Workday.
- Search for Register API Client for Integrations and select it.
- Enabling Non-Expiring Refresh Tokens ensures the token does not expire and must be manually revoked.
- Specify Client Name and Scope (Functional Areas). Minimum scopes for WFM functionality:
- Integration
- Staffing
- Time Off and Leave
- Click OK and copy the Client ID and Client Secret. Save them securely.
- Search for View API Client, then click the API Client for Integrations tab.
- Select the API Client you created.
- Click the ellipsis icon
and select API Client. - Click Manage Refresh Tokens for Integrations.
- Enter the Workday account created in the previous section (ISU_WFM).
- Click OK and save the generated refresh token securely.
How to set up the Workday Connector app
To set up the Workday for Workforce Management connector, the Workday instance has to be associated with the Workday for Workforce Management connector available in the Zoom App Marketplace. Follow these steps:
- Enter the following required information:
- Click Submit.
How to delete the Workday for WFM integration connection
From Zoom App Marketplace
After you have established the Workday for WFM integration connection, it cannot be edited. If you need to make changes due to any change in configuration setting, you can delete the connection and create it again.
Note: This will delete the connection from WFM and stop the sync.
- Sign in to the Zoom web portal.
- In the navigation menu, expand Advanced and click App Marketplace.
- Search for Workday for WFM. Click the ellipsis icon
and select Settings. - Go to Connections tab.
- Click on ellipsis icon
next to your connection name. - Select Delete.
- Click Delete to confirm.
From Workforce Management
After you have established the Workday for WFM integration connection, it cannot be edited. If you need to make changes due to any change in configuration setting, you can delete the connection and create it again.
Note: This will not delete the connection from App Marketplace. The same connection can be reused.
- Sign in to the Zoom web portal.
- In the navigation menu, click Workforce Management.
- In the sidebar, click the Preferences tab.
- Go to Integrations tab.
- Click on the ellipsis icon
next to your connection and select Delete integration. - Click Delete to confirm.
How your data is used
The Workday Connector allows Zoom Communications Inc. to manage your employee absence management. To ensure proper functionality, you'll need to add a refresh token with the appropriate permissions (scopes). The permissions you share with Zoom Communications Inc. include:
- Integration: Zoom Communications Inc. will have permission to retrieve time-off types from the connected Workday instance.
- Staffing: Zoom Communications Inc. will have permission to search and list workers and worker details.
- Time Off and Leave: Zoom Communications Inc. will be authorized to:
- Access existing leave categories, types, and employee leave balances.
- Submit absence requests on behalf of employees.
- Create Enter Time Off entries on behalf of supervisors.
- Modify existing absence requests submitted through Zoom Communications Inc.
Admin experience
Administrators are required to incorporate the Workday Connector from Zoom App Marketplace and establish the connector with the required information.
- A new integration must be configured in Workforce Management by selecting the established connector.
- Administrators are required to establish a mapping correlation between workforce management out-of-office activities and the corresponding Workday leave codes for all applicable categories and classifications.
- Administrators shall have the capability to incorporate Workday employee records for each agent within the Workforce Management user interface.
Note: Currently, only one Workday Connector/App can be implemented or added per account.
Supervisor experience
- Supervisors shall have access to view all out-of-office requests from agents through a unified interface.
- Supervisors possess the authority to approve or deny out-of-office requests submitted by agents.
- Supervisors maintain the capability to delete time-off requests for agents, and these changes will be reflected in the Workday system.
- Upon supervisory approval, Workforce Management shall generate a time-off request on behalf of the agent, which will receive automatic approval (functions effectively with basic time-off approval protocols).
Agent experience
- Agents may submit out-of-office requests by selecting the appropriate Workforce Management activity.
- Agents shall have access to view their accrued leave balances.
- All approved out-of-office requests will be displayed in the Workforce Management interface
- Agents have the capability to withdraw previously submitted leave requests.
Support responsibilities
Zoom
For the following issues, contact Zoom Support:
Marketplace:
- Issues adding the Workday app to an account
- Issues when updating or configuring Workday
Workforce Management (WFM):
- Time-off codes not visible after integration
- Issues mapping WFM users via Employee ID
- Out-of-office (OOO) requests in WFM not reflecting in Workday
- Discrepancies in user balances between WFM and Workday
Workday
For the following issues, contact Workday Support:
- Creating an integration user (a designated user for all integration activities)
- Setting up an API client for integration
- Generating a refresh token
- Creating time-off plans and assigning them to workers