An integration between Radancy's Employee Referrals and ATS serves to enable Recruiters to avoid performing manual tasks so that the application tracking system remains the leading system during the recruiting process.
The following connections can be established to integrate:
- Job import to Employee Referrals
- Export Candidate Application or Forwarding the candidate based on the application URL
- Talent Scout feedback export from Employee Referrals
- Recruiter rating import to Employee Referrals
- Application status import to Employee Referrals
To configure the steps below, you need to generate an API key (see how here) and configure webhooks (see here) in your Employee Referrals account.
Job import
Jobs in Employee Referrals contain a minimum set of fields that are required:
- Job title*
- Job reference number
- Job posting URL
- Department*
- Location*
- Contact person*
- Reward*
- Branding
- Featured Job
- Hiring team
- Job description*
*mandatory for job publication
The fields location, department, contact person, reward plan, and job branding expect UUIDs while creating a job via POST job endpoint (see: Create a job). The publication of a job requires all mandatory fields and a status update. Jobs that don't fulfill the requirements are saved as drafts and are only visible to recruiters and admins.
Steps to follow
- Request departments, locations, users, rewards, and job brandings
- Create a job (https://docs.1brd.com/#create-a-job)
- Update job status (https://docs.1brd.com/#update-a-jobs-status) to ACTIVE_PUBLISHED
- Optional: Update job status (https://docs.1brd.com/#update-a-jobs-status) to ACTIVE_CLOSED
Alternatively, it is possible to provide Radancy with an XML feed that will be configured on a specific account with a sync period of 60 minutes (read more here).
Export Candidate Application
When the application is entirely completed in Employee Referrals, the candidate completes the standard application form. Employee Referrals applications contain the following information:
- UUID of the application in Employee Referrals
- Status of the application ("In Progress" → Application)
- Application date
- Company
- Company ID (UUID of the account)
- Name of the company (descriptive name of the account)
- Domain Name
- Website
- Applicant
- UUID
- First Name
- Last Name
- Referrer (= Talent Scout)
- Company ID (UUID of the account)
- First Name
- Last Name
- Locale
- Role
- Job
- UUID of the job in Employee Referrals
- Reference Number
- Title
- Files
- Applicant image
- Channel (e.g. Facebook...)
Steps to follow
- Configure webhooks "job_application.received" (Configure webhook)
- Wait for an application to be completed and the event will be sent.
Forwarding the candidate based on the application URL
The candidate adds their first and last name and email in Employee Referrals and then they are redirected to the Application URL.
Please note: this feature has to be enabled by the Radancy team and the URL is required when publishing the job.
The link that forwards the candidate is enhanced by the following information:
- Tenant ID
- Referral ID
- Source (firstbird or Radancy's Employee Referrals)
Additional information about the Referral can be requested via the Get a single job application endpoint which offers additional information, such as the name of the Talent Scout.
Steps to follow
- Wait for a candidate to apply with the correct source
- Request applications and store application ID (GET /v1/companies/{companyId}/applications?sourceId={referralId}&expand=applicant) and name of the Talent Scout
- Accept legal terms (PUT /v1/companies/{companyId}/applications/{applicationId})
-
Update application status (PUT /v1/companies/{companyId}/applications/{applicationId}) to FINISHED
Talent Scout feedback export from Employee Referrals
Learn about Talent Scout feedback here.
The Talent Scout feedback includes different fields, such as Referral Status (Positive, Neutral or Negative), Relationship (Where do you know each other from?) and Feedback. Those fields can be merged into one free-text field.
It is possible to use webhooks (see: Webhooks) to be notified about new Talent Scout feedback (event “job_application.referral_added”) instead of requesting the API on a regular basis.
Steps to follow
- Configure webhooks "job_application.referral_added" (Configure webhook)
- Wait for a Talent Scout to add feedback and the event will be sent.
Recruiter rating import to Employee Referrals
Learn about Plus Points here.
Recruiters can rate a Referral with Plus Points and add a personal message for Talent Scouts. Employee Referrals provides the endpoint to update the rating and add the personal message.
Please note that the rating should only be sent once. The Talent Scout receives only points for the first rating. The personal message is only visible in the email sent to the Talent Scout.
Steps to follow
- Wait for a recruiter to rate the application in ATS (and add a personal message)
- Add rating (and personal message) https://docs.1brd.com/#rate-a-job-application
Application status import to Employee Referrals
The status of the Referral can be updated (marked as Hired or Closed) with the PUT status endpoint.
Please note that the status “HIRED” required different information, such as the starting date (see: Hire a job application) compared to the “CLOSED” status (see: Close a job application). Both updates trigger notifications for the Talent Scout.
Steps to follow
- Wait for a recruiter to complete recruiting process in ATS
- Update status of referral/ application:
- If Hired: https://docs.1brd.com/#hire-a-job-application
- If Rejected: https://docs.1brd.com/#close-a-job-application