EmployUs + Workday Integration Guide

Matthew Cotter 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
Enter 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

email

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

email

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"}

How did we do?

Supported Integrations

Contact