# 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://files.readme.io/56961763fd0690573dd89ae3cd218a56f2c7d1e625de3a0dbd9764bddfb40915-image.png" align="center" caption="Figure 1.1: Configure the Business Process Step" />



<Image src="https://files.readme.io/2a3fa5dd659b10d4b22c8a5e580641655295fca528376b3cabe964b44c3ff811-image.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://files.readme.io/8234b501a0d8e7a419009e2658973f715d6d77b6386388fcc589c63e02fd3a27-image.png" align="center" caption="Figure 2.1: Configure the Business Process Step" />



<Image src="https://files.readme.io/84d6216471529817bc1a39e17ebac7df1311363a2cf3f62dd1e1f73458308a77-image.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://files.readme.io/24003b9803f5f5cd4f908a052bb95b3965e3b1f3eecd309d00e4d6e94bb9f250-image.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://files.readme.io/d11ce046c98d15f82889ebf2be55c4d6329f7f1eaf68e6125080a91e757cb468-image.png" align="center" caption="Figure 3.1: Custom Report for the IDV Integration" />



<Image src="https://files.readme.io/70783e1cecbaedbecffcb8924c284c19fe0e9d0b3be1baf775fff98aa9411838-image.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://files.readme.io/8389bf254b629af156dda89a5b954cccfff67240778bc37c9282e4afebfebd1b-image.png" align="center" caption="Figure 4.1: Custom Object for the eKYC details" />



<Image src="https://files.readme.io/e98111eac34925ef3c93fbcc062271008c4564ec217c5a900a7ff53f190a6be9-image.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://files.readme.io/f73fad31a76afa8cbe6e8aed8bee207556405f64f63a94272c95c0192c633f61-image.png)

Figure 5.1: Custom Object for the IDV Details


<Image src="https://files.readme.io/024a248e545109e5353c80873bb7c17e280576fee0e7c6ac438006e91f205796-image.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 />