EmployUs + Workday Integration Guide
Updated
by Matthew Cotter
Integrating your ATS or HRIS with EmployUs can be accomplished via multiple methods (API, SFTP, XML, or manual file uploads) based on your internal resources, time constraints, and your applicable ATS or HRIS’s integration capabilities.
For Workday HCM and Recruiting, EmployUs there are two options to integrate listed below.
1) API Access
In order to provision an API user, you will need the following information
- Workday URL
- Workday Username & Password (Instructions to set up a system integrator user here)
- Workday Tenant Name (Example: https://wd5-services1.workday.com/TENANT_NAME)
How to Find Your Workday URL
Search in Workday for Public Web Services
Open the Public Web Services Report
Hover over Human Resource and click the three dots to access the menu
Click Web Services, and then click View WSDL
Navigate to the bottom of the page that opens and then you'll find the host
Copy everything until you see /service and paste below. This should look something like https://wd5-services1.myworkday.com/ccx
Once this information is provided, EmployUs handles the work to enable the integration. Most integrations can be enabled within 2 weeks during the implementation process.
2) Custom Reports
Alternatively, customers can integrate using the Workday Reporting-as-a-Service (RaaS) functionality. Custom Reports (advanced type) can be exposed as a web service and EmployUs can pull data from these to update your job, referral, and employee data inside EmployUs. After you create these reports, please email the respective JSON URL to integrations@employus.com for processing. This option is designed for customers who need to limit the amount of information shared with 3rd parties. It requires a customer to configure the reports and fields from inside of Workday.
HRIS Integration
Integrating your HRIS (i.e. Workday HCM) helps to automatically add and remove employees to and from your employee referral program. These integrations are optional and in lieu of an integration you may upload a current list of employee’s via our self-service data import feature found on the Connector Page.
Relevant Integration
- Employee Feed
ATS Integration
Integrating your ATS (i.e. Workday Recruiting) ensures your employee referral program is synced with the rest of your recruiting processes.
Relevant Integration
- Job Feed
- Hire Feed
Employee Feed
This feed contains all active employees currently employed by the client and is used for adding, updating, or archiving Employees to the EmployUs system. Additional custom fields can be added in addition to department and location for creating custom lists for referral campaigns (i.e. veteran status may be included to create a custom Veteran audience) or determining referral reward eligibility (i.e. certain seniority/job levels may not be eligible).
RaaS Set Up
Clients may prefer to use the standard Core Connector-Worker available as well.
Advanced Report Configuration Guide | |
Name | EmployUs.EmployeeFeed.{ClientName} |
Type | Advanced |
Data Source | Worker |
Data Source Filter | Worker Filter |
Data Source Type | Indexed |
Primary Business Object | Worker |
Fields
Employee Import | ||
name | Employee’s full name | required |
Employee’s email address | At least 1 is required | |
phone | Employee’s mobile phone number | |
department | Employee’s current department | optional |
location | Employee’s current location (city, state, country) | optional |
id | Employee’s unique identifier | optional |
Example JSON Record
{ "name" : "Charlie Employee", "email" : "charlie@email.com", "phone" : "+19198110091", "department" : "Sales", "location" : "Raleigh, NC, USA", "id" : "1234567890" } |
Job Feed
This feed contains all currently active job postings for a client that are published publicly for referrals to apply. This will update the jobs in EmployUs by adding or updating all jobs in the feed. Any jobs not found in the feed will be marked as inactive and no longer shown on EmployUs. Additional custom fields can be included if needed to support custom reward bonus rules.
RaaS Set Up
Clients may prefer to use the standard Core Connector-Job Postings available as well.
Advanced Report Configuration Guide | |
Name | EmployUs.JobFeed.{ClientName} |
Type | Advanced |
Data Source | Job Postings |
Data Source Filter | Job Postings Filter |
Data Source Type | Indexed |
Primary Business Object | Job Postings |
Fields
Active Job | ||
id | Unique ID for job | required |
title | Job title | required |
url | Apply url link for the job | required |
bonus | Number or currency value of referral bonus | optional |
description | Job description (HTML or plain text) | optional |
location | Location of job (City/State) | optional |
type | Department or category for the job | optional |
notify | Email address to receive referral notifications for job | optional |
Example JSON Job Record
{ "id" : "job1", "title" : "Software Engineer", "url" : "https://cadient.com/jobs/job1/apply", "bonus" : "3000.00” "description" : "<div>......</div>", "location" : "Raleigh, NC", "type" : "Engineering", "notify" : "referrals+job1@company.com"} |
Hire Feed
This feed contains any hired candidates within the past 30 days to see if they came from a referral in EmployUs. If the new hire is found in the EmployUs system then all matching referrals will be updated to hired.
Additional Options
- This may be replaced by the Employee Feed, if the employee feed contains the personal email and/or phone number of the candidate record.
- This may be enhanced by including all candidates, updated within the past 30 days, to cross reference any existing candidate or referral data inside of Workday. In this case, please be sure to include the Worker ID associated with any referred candidate records.
RaaS Set Up
Advanced Report Configuration Guide | |
Name | EmployUs.HireFeed.{ClientName} |
Type | Advanced |
Data Source | Candidate |
Data Source Filter | Candidate Filter |
Data Source Type | Indexed |
Primary Business Object | Candidate |
Fields
Hire Update | ||
name | Seeker’s Full Name | required |
Seeker’s Primary email address | At least 1 is required | |
email2 | Seeker’s Alternate email address | |
phone | Seeker’s Primary phone number (mobile) | |
phone2 | Seeker’s Alternate phone number (mobile) | |
start | Date the seeker starts (ISODate Format) | optional |
markedHired | Date the seeker was hired (ISODate format) | optional |
jobId | Unique ID of job the Seeker was hired for | optional |
jobTitle | Title of job the Seeker was hired for | optional |
Example JSON Record
{ "name" : "Sally Seeker", "email" : "sally@work-email.com", "email2" : "sally@personal-email.com", "phone" : "+12993887377", "phone2" : "+16565154484", "start" : "2020-03-01T12:00:00.000Z", "markedHired" : "2020-01-31T12:00:00.000Z", "jobId" : "job1", "jobTitle" : "Software Engineer"} |