---
title: "Workday Recruiting"
url: "https://developer.incode.com/ecosystem-workforce/workday-recruiting/"
section: "ecosystem-workforce"
group: "Recruitment Integrations"
version: "v1.1"
status: "live"
---
# Workday Recruiting

This page covers Incode's identity verification integration with Workday. The integration uses facial biometrics, document authentication, and fraud detection to verify candidates during the hiring process.

***

## Workday Studio Integration

Incode provides a prebuilt Workday Studio integration package. It includes three independent Studio integrations, each covering a specific part of the onboarding and verification lifecycle:

- **eKYC Integration (INT00N\_eKYC\_Candidates\_Incode)**:**&#x20;**&#x53;ecurely sends candidate data from Workday to Incode for<br />electronic Know Your Customer (eKYC) checks and writes results back.
- **IDV Integration (INT00N\_IDV\_Candidates\_Incode)**: Retrieves biometric and document verification results from Incode and writes them into Workday.
- **Email Delivery Integration (INT00N\_Onboarding\_Email\_Incode)**: Sends personalized onboarding URLs and verification links to candidates using Workday's notification framework.

Each integration is delivered as a Workday Studio project file ready for deployment. They are modular; you don't need to use both eKYC and IDV together.

***

## eKYC Integration

The `INT00N_eKYC_Candidates_Incode` integration sends candidate profile data from Workday to Incode for eKYC checks. Results are returned to Workday and stored on the candidate's **Incode Details** tab. You can place this integration at any of the following hiring stages: Assessment, Background Check, Offer, or Pre-Hire.

This integration:

- Extracts candidate demographic data from Workday.
- Sends the data securely to the Incode verification API.
- Retrieves risk scores, verification statuses, and supporting metadata.
- Updates the candidate's **Incode Details** tab in Workday.


<Image src="https://developer.incode.com/assets/4e32afa823f3e58c6e1a7d13a72ddf4a.png" align="center" caption="Figure 1.1: Configure the Business Process Step" />



<Image src="https://developer.incode.com/assets/e4fc3822ffa0426af10fe38974290a42.png" align="center" caption="Figure 1.2: Receive the eKYC score response from Incode into Workday" />


<br />

***

## Email Delivery Integration

The `INT00N_Onboarding_Email_Incode` integration sends onboarding URLs and verification links to candidates using Workday's notification framework. You can place it at the Assessment, Background Check, Offer, or Hire stage.

This integration supports:

- Automated delivery of individualized onboarding URLs to candidates.
- Customizable email templates using Workday's notification framework.
- Flexible placement within hiring business processes.


<Image src="https://developer.incode.com/assets/38a977b7024bbae937fef1e007405307.png" align="center" caption="Figure 2.1: Configure the Business Process Step" />



<Image src="https://developer.incode.com/assets/d65a5f1d430d45e0f0f2b1cb908f9109.png" align="center" caption="Figure 2.2: Define the Business Process Condition" />


<br />

### **Onboarding Notification Template**

The notification template lets HR and Talent Acquisition teams send candidates clear, personalized instructions. Using this template, you can:

- Personalize message content.
- Include dynamic fields.
- Embed the onboarding URL.
- Align with organizational branding.

> 📘 **Note**
>
> You can use a custom BP Notification Template to align notifications with your company's communication standards.


<Image src="https://developer.incode.com/assets/686b53dde7f4fd67859bc4a0e100a06a.png" align="center" caption="Figure 2.3: Email delivery of the Onboarding URL for Identity Verification" />


***

## IDV Integration

The `INT00N_IDV_Candidates_Incode` integration retrieves biometric and document verification results from Incode and writes them into Workday. It retrieves IDV results on a scheduled basis: hourly, daily, or as configured.

This integration:

- Opens candidate sessions with document and biometric submissions.
- Extracts verification attributes such as:
  - Document authenticity validations
  - Biometric (facial match) scores
  - Fraud indicators
  - Session timestamps and metadata


<Image src="https://developer.incode.com/assets/98138a100b6696f06b7e85e154374c5a.png" align="center" caption="Figure 3.1: Custom Report for the IDV Integration" />



<Image src="https://developer.incode.com/assets/27f667878492fadf33f79ce48dcef1ac.png" align="center" caption="Figure 3.2: Identity verification details viewable in the Workday Candidate Profile" />


<br />

***

## eKYC Custom Object

The eKYC custom object stores identity verification data returned from Incode. It holds:

- Verification outcomes
- Risk categorization details
- Identity validation notes
- Incode session references

This object supports downstream consumption in reports, dashboards, audits, and compliance checks.


<Image src="https://developer.incode.com/assets/29df939ab7e7b0d00ee22b8ce60d2a51.png" align="center" caption="Figure 4.1: Custom Object for the eKYC details" />



<Image src="https://developer.incode.com/assets/9b8b6ebdcda9e0550874a81c349b9dc1.png" align="center" caption="Figure 4.2: Custom Object Fields for eKYC Details" />


<br />

***

## IDV Custom Object

The IDV custom object stores document verification and biometric results from Incode. It holds:

- Document inspection results (authenticity, tampering indicators)
- Biometric comparison metrics (face match scores, liveness checks)
- Risk indicators derived from Incode's scoring engine
- Reference keys for reconciliation and traceability

![](https://developer.incode.com/assets/7487f389b6ce567c330191b5bb9b5507.png)

Figure 5.1: Custom Object for the IDV Details


<Image src="https://developer.incode.com/assets/e5461cc9042b0cb34a4148133291f9d2.png" align="center" caption="Figure 5.2: Custom Object Fields for the IDV Details" />


<br />

***

## Integration Architecture

Data flows through the following pattern:

```
Workday → Workday Studio → Incode REST APIs → Workday Studio → Workday Custom Objects
```

The integration uses the following security measures:

- All data exchanged between Workday and Incode is encrypted over HTTPS.
- Authentication uses API keys stored securely in Workday's Integration System Credentials.
- Logging, retries, and exception tracing are built into the Studio integrations.

<br />