Workday Integration Overview
Powered by Merge.dev Unified API
Visage integrates with Workday via Merge.dev, ensuring a secure, standardized, and maintenance-free connection. This integration allows for bi-directional data sync, enabling automated sourcing, applicant creation, and status updates. Sync behavior is continuous or near-real-time, depending on Workday tenant capabilities.
Consent-First Applicant Creation
Visage only creates candidate or applicant records in Workday after explicit candidate interest and consent have been captured. Prospects who opt out, disengage, or do not respond are never pushed into Workday, ensuring compliance with GDPR, works council expectations, and internal talent governance standards.
Authentication
We use Merge Link to handle authentication securely. You do not need to share raw API keys directly with Visage. Instead, you will authenticate via a secure OAuth flow or by providing specific credentials through the Merge Link modal. Workday credentials are securely managed by Merge.dev and can be revoked at any time; Visage never stores raw Workday credentials.
Required Permissions
- Get Candidates: To check for duplicates.
- Get Jobs: To import open requisitions.
- Create Candidates: To export sourced profiles.
- Update Applications: To sync status changes.
Sync Frequency
Data sync intervals depend on the specific data model and your plan. Below are the standard sync frequencies for the Workday integration via Merge.
| Data Model | Standard Sync | High Frequency |
|---|---|---|
| Candidates | Every 24 hours | Every 30 minutes |
| Applications | Every 24 hours | Every 30 minutes |
| Jobs (Requisitions) | Every 24 hours | Every 1 hour |
| Departments | Every 24 hours | Every 1 hour |
Note: Webhooks can be configured for real-time updates on critical events (e.g., "Candidate Hired"), bypassing the polling schedule.
Core Workflows & API Mapping
The following workflows outline how data flows between Visage and Workday, mapped to specific Merge Unified API endpoints.
1. Pull Jobs into Visage
Visage pulls open job requisitions from Workday to allow sourcers to attach candidates to specific roles.
2. Create Applicants (Export)
When a candidate is sourced and approved in Visage, we create a new candidate profile in Workday. Candidate or applicant creation happens only after interest is confirmed, respecting your Workday recruiting workflow and requisition configuration.
{
"first_name": "Jane",
"last_name": "Doe",
"email_addresses": [{ "value": "[email protected]", "type": "PERSONAL" }],
"phone_numbers": [{ "value": "+15550102", "type": "MOBILE" }],
"applications": [{ "job": "job_id_123" }]
}3. Update Candidate Status
Visage periodically checks the status of applications in Workday to update the pipeline view in Visage (e.g., moving a candidate from "Sourced" to "Interviewing").
4. Duplicate Check
Automatic Deduplication Logic
Before creating any record, Visage checks for existing candidates in Workday via Merge.dev to prevent duplicates, respecting Workday’s native matching rules. If a match is found, we link the new application to the existing candidate profile instead of creating a duplicate.