EmployUs Public API Documentation

Matthew Cotter Updated by Matthew Cotter

Hire Update API 

This is to send all new hires to EmployUs to check if they came from a referral. If the new hire is found in the EmployUs system then all matching referrals will be updated to hired.

Request
Method POST 
URL https://refer-us.com/_public/api/v1/hires 
Headers Authorization: Bearer {{token}} 
Content-Type: application/json 
Body JSON Array of Hire Updates, limit of 1000 
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"
    "programid" : "e124567890"
}

Hire Update Fields

name

Seeker’s Full Name

Required

email

Seeker’s Primary email address

At least 1 contact method is required

email2

Seeker’s Alternate email address

At least 1 contact method is required

phone

Seeker’s Primary phone number (mobile)

At least 1 contact method is required

phone2

Seeker’s Alternate phone number (mobile)

At least 1 contact method is required

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

programid

Connector’s program unique identifier (i.e. branch or department ID)

optional

Connector Import API 

This is for adding or updating connectors to the EmployUs system, so they can be invited to refer.

Request
Method POST 
URL https://refer-us.com/_public/api/v1/connectors
Headers Authorization: Bearer {{token}} 
Content-Type: application/json 
Body JSON Array of Connector Imports (check fields below)
Example JSON Record
{
"name" : "Charlie Connector",
"email" : "charlie@email.com",
"phone" : "+19198110091"
"programid" : "e124567890"
}
Connector Import Fields

name

Connector’s full name

required

email

Connector’s email address

At least 1 contact method is required

phone

Connector’s mobile phone number

At least 1 contact method is required

programid

Connector’s program unique identifier (i.e. branch or department ID)

optional

How did we do?

EmployUs + Cadient Talent Integration Guide

EmployUs + Bullhorn Integration Guide

Contact