Setup

Connect Workday to Ravenna through the Merge.dev integration link flow to enable automatic employee, department, and group synchronization.

Connect to Workday through Merge.dev for unified HRIS data access

This guide walks you through connecting your Workday instance to Ravenna for employee and group synchronization.

Prerequisites

Before you begin, ensure you have:

• An active Workday tenant
• Admin or integration administrator access to your Workday instance
• Permission to authorize third-party integrations

Setup guide

1. Navigate to integrations

   1. Go to Settings > Integrations
   2. Find Workday in the HRIS section
2. Start the connection

   Click Connect on the Workday integration card to begin the Merge Link flow.

3. Complete Merge Link authorization

   1. A Merge Link dialog opens to guide you through the connection
   2. Select Workday as your HRIS provider
   3. Provide your Workday tenant URL and credentials
   4. Authenticate with your Workday admin credentials
   5. Review and accept the requested data permissions
   6. Click Finish to complete the connection
4. Configure sync settings

   After connecting, configure your sync preferences:

   • Employee status filter: Choose which employment statuses to sync (default: Active only)
   • Group type filter: Select which group types to sync (default: Teams and Departments)
5. Wait for initial sync

   The initial data sync begins automatically after connection. Employee and group data will be available once the sync completes.

   Data syncs automatically every 24 hours after the initial sync. You can view the last sync time in the integration settings.

Troubleshooting

Merge Link authorization fails

Cause: Incorrect credentials or insufficient permissions

Solution:

• Verify your Workday tenant URL and credentials are correct
• Ensure you have integration administrator access in Workday
• Check that API access is enabled for your Workday tenant
• Contact your Workday administrator if third-party integrations are restricted
• Try the connection again with a different browser

Employees not syncing

Cause: Sync not yet complete or filter settings excluding employees

Solution:

• Check the last sync time in integration settings
• Verify your employee status filter includes the statuses you expect (e.g., Active)
• Wait for the next 24-hour sync cycle
• Try disconnecting and reconnecting the integration

Groups or departments missing

Cause: Group type filter may be excluding certain group types

Solution:

• Check that your group type filter includes Teams and Departments
• Verify that the groups exist in Workday
• Wait for the next sync cycle to pick up new groups