The Time Off Sync plugin allows full-time employees hired on Deel to log their time off in Workday. Deel then syncs that data back periodically so it can be included in payroll processing.
Data synced: Time off requests, approved time off days
Sync direction: Bidirectional (Workday to Deel)
Available for: Global Payroll (GP)
In this article
- Before you begin
- Activating domains for optional plugins
- Workday setup
- Deel setup
- Setting up Leave of Absence (LOA) sync
Before you begin
Before starting the PTO setup, make sure you have completed the required parts of the common connection setup. If you haven't done this yet, go to How to connect Workday GPC to Deel first.
Parts 1 and 2 of the common setup must be complete before continuing:
- Part 1: Connecting Workday to Deel - creating an ISU, setting up security groups, an API client, tokens, and connecting to Deel
- Part 2: Setting up DCoD - integration system, external payroll vendor, and vendor mapping
Required permissions
Before you enable the PTO plugin, add the following permissions to your security group in Workday. Use the Maintain Permission for Security Group task to add these.
| Permission | Access Type | User Group |
|---|---|---|
| Worker Data: Time Off (Time Off) | Get/Put | ISU |
Access type definitions:
- Get = Read-only access via the integration layer
- Get/Put = Read and write access via the integration layer
Activating domains for optional plugins
Some plugins require additional domain security policies to be active in Workday before they can be enabled in Deel. Each time you enable a new plugin, complete the steps below for that plugin before proceeding to its setup guide.
To find out which domains are required for the plugin you are setting up, refer to the Security permissions reference and locate the column for your plugin.
Step 1: Activate the required domains
- Search for the domain using the domain: prefix. For example, domain: Set Up: Payroll Interface.
- In the Domain Security Policy section, use the related actions to go to Domain Security Policy > Enable.
- On the following screen, confirm the enablement.
- Repeat for any remaining domains required for your plugin.
If a domain is already active, skip it and move to the next one.
Step 2: Assign users or groups to domains
- Open the domain.
- In the Domain Security Policy section, use the related actions to go to Domain Security Policy > Edit Permissions.
- In the Report/Task Permissions section, check that the required security groups are present. If any are missing, add them.
- Save your changes.
To add users to the relevant security group, use the Assign Users to User-Based Security Group task.
Step 3: Activate pending security policy changes
- Launch the Activate Pending Security Policy Changes task.
- Enter a comment describing the reason for the change and save.
For more information, visit Activate Pending Security Policy Changes in the Workday Community.
Workday setup
Step 1: Add PTO scopes to the API client
- Launch the View API Clients report and go to the API Clients for Integrations tab.
- Select the API client created during the common setup.
- Use the related actions to go to API Client > Edit API Client for Integrations.
- Add the Time Off and Leave scope.
- Save your changes.
Step 2: Activate pending security policy changes
- Launch the Activate Pending Security Policy Changes task.
- Enter a comment describing the reason for the change and save.
Deel setup
Step 3: Enable the time off sync plugin
- In the Plugins and settings tab, locate the Global Payroll - Time Off Sync plugin and click Enable.
- Click Configure next to an entity.
- Map the Deel and Workday PTO types, then click Confirm.
- On the confirmation dialog, click Enable.
- Repeat for any remaining entities.
Setting up Leave of Absence (LOA) sync
If your organisation uses Workday's Leave of Absence module, you can sync LOA data directly into Deel's payroll report alongside existing compensation, allowances, and time tracking data.
Setting up LOA involves two distinct steps that must be completed in order:
- LOA sync must be enabled - this is a backend change that makes Deel fetch LOA data from Workday's standard Leave of Absence path. Without this, LOA types will not appear in Deel at all.
- LOA mapping must be configured in the Deel UI - this assigns each LOA type to a corresponding Deel long-term leave type so the data can be processed correctly in payroll. Enabling the sync without completing the mapping means data flows in, but cannot be used.
Before you begin
- The PTO plugin must be enabled and configured
- PTO types must be configured in Workday as external earnings and deductions before the first sync runs. Any types not configured ahead of the first sync will not appear in Deel's mappings until a subsequent sync picks them up.
- Contact your Deel representative to enable LOA sync for your account, as this requires a configuration change on the Deel side before the steps below will take effect
Step 1: Document existing PTO mappings
Before enabling LOA sync, record all current PTO mappings in Deel across every entity.
Step 2: Enable LOA sync
Contact your Deel representative to enable the LOA sync feature for your account. Once enabled, Deel will use the DCoD API path to fetch Leave of Absence data from Workday's standard LOA path.
Step 3: Trigger a sync and re-map
- From the integration's main page, click Sync Workday GPC to trigger a manual sync.
- Go to the Plugins and settings tab and open the Global Payroll - Time Off Sync plugin.
- Check the time-off mappings and remap any types that were cleared, using the documentation from Step 1.
- LOA entries will now appear in the mapping UI with a visual indicator distinguishing them from standard PTO entries.
Step 4: Map LOA entries to Deel leave types
- In the mapping UI, locate the LOA entries — these are visually distinguished from standard PTO entries with a label indicating they are sourced from the Leave of Absence table.
- Map each LOA entry to the corresponding Deel long-term leave type.
- Save your mapping.
How LOA sync works
Once mapping is configured, LOA data syncs automatically as part of the existing PTO sync schedule. LOA entries logged in Workday are fetched from the standard Leave of Absence path and synced to Deel for payroll processing.
LOA will only appear in the payroll output once the request has been approved in Workday. Pending requests are not synced.
Troubleshooting
LOA is not showing in the payroll output
Check that the LOA request has been approved in Workday — LOA only syncs after approval, not when the request is submitted.
Past LOA records are not visible
Historical LOA records may not appear automatically. Contact your Deel representative to request a backdated sync.
A PTO type is missing from the mappings after enabling
PTO types must flow through a sync before they can be mapped — they cannot be pre-mapped against types that haven't been picked up yet. Trigger a sync and check again. If the type is still missing, confirm it is correctly configured in Workday as an external earning or deduction.
Previously mapped types disappeared after enabling
This is expected when migrating to the DCoD data path. Use the documentation from Step 1 to remap the affected types. If the volume of remapping is large, contact your Deel representative for assistance.
Known limitations
- There is no way to pre-map PTO types before they have been picked up by a sync. If historical types are needed, contact your Deel representative.
- LOA sync is only available for clients on the DCoD integration path.