How to Import and Export Referrals

Matthew Cotter Updated by Matthew Cotter

In order to support the real-time import of referrals into the ATS or export of referrals from your ATS, EmployUs will need API credentials with the ability view, add, and edit data.

When importing referrals into the ATS, EmployUs provides the following fields when the following conditions are met:

  1. Referral is sent from employee to job seeker
  2. Job seeker indicates interest and confirms email & phone
  3. EmployUs triggers referral import integration to ATS

Referral Import Fields into ATS

seeker.name

Seeker’s Full Name

required

seeker.email

Seeker’s Primary email address

required

seeker.phone

Seeker’s Primary phone number (mobile)

required

connector.name

Connector/employee's name

required

connector.email

Connector/employee's email

required

connector.id

Unique ID of the connector who referred (employee ID in HRIS/ATS)

optional

jobId

Unique ID of job the Seeker was referred for

optional

programId

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

optional

seeker.resume

Job seeker's uploaded resume (URL)

optional

Sample JSON

{
"seeker": {
"id": "123456",
"name": "Sally Seeker",
"email": "sally@email.com",
"phone": "+19198110091",
"resume": "https: //storage.googleapis.com/media.landbot.io/19993/customers/77312093/XXXXXXXXX.pdf"
},
"connector": {
"id": "124567",
"name": "Charlie Connector",
"email": "charlie@email.com"
},
"job": "1234567",
"program": "e124567890"
}

Referral Export Fields from ATS

seeker.name

Seeker’s Full Name

required

seeker.email

Seeker’s Primary email address

required (if phone is not present)

seeker.phone

Seeker’s Primary phone number (mobile)

required (if email is not present)

connector.name

Connector/employee's name

required

connector.email

Connector/employee's email

required

created.date

Date in Standard ISO Format when the referral was created

required

connector.id

Unique ID of the connector who referred (employee ID in HRIS/ATS)

optional

jobId

Unique ID of job the Seeker was referred for

optional

programId

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

optional

status

Job seeker's current status in the ATS

optional

How did we do?

EmployUs + Oracle (Taleo/PeopleSoft) Integration Guide

EmployUs + iCIMS Integration Guide

Contact