How to Import and Export Referrals
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:
- Referral is sent from employee to job seeker
- Job seeker indicates interest and confirms email & phone
- 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 |