-
Notifications
You must be signed in to change notification settings - Fork 2
Home
Posting Title* Posting Title* Client Name* Job Opening ID
Retrieve active jobs
GET /api/v1/positions/?qf=[!isArchived][!isDraft][!dueDate:before:2019-01-01]
100 records in a single API call
The value for lastModifiedTime parameter should be in yyyy-MM-dd HH:mm:ss format.
"val": "Email Opt Out",
"content": "false"
"val": "Is Locked",
"content": "false"
"val": "Is Unqualified",
"content": "false"
"val": "Candidate Status",
"content": "Associated"
"val": "CANDIDATEID",
"content": "473737000000551093"
"val": "Candidate ID",
"content": "MBI_1374_CAND"
"val": "First Name",
"content": "Saleem"
"val": "Last Name",
"content": "Bek"
"val": "Email",
"content": "saleem.khairbek@gmail.com"
"val": "Mobile",
"content": "779-777-9270"
"val": "Created Time",
"content": "2018-09-15 03:34:27"
"val": "Updated On",
"content": "2018-09-15 03:34:27"
"val": "Last Activity Time",
"content": "2018-09-15 03:34:28"
JOBOPENINGID
Fetch the candidates that have applied since the last API call. Below example uses All fields. If this is not required, use Candidates(Last Name,Website,Email,etc)
https://recruit.zoho.com/recruit/private/json/Candidates/getRecords?authtoken=2f395f39cedc1b3e8e5eb92814460db8&scope=recruitapi&version=4&newFormat=1&duplicateCheck=2&selectColumns=All&lastModifiedTime=[last API call time]Creating an Interview in HireVue
POST /api/v1/positions/[pid]/interviews/
{
"firstName": "[candidate first name]",
"lastName": "[candidate last name]",
"email": "[candidate email address]",
"language": "en",
"suppressCandidateNotifications": true,
"candidateExitUrl":"https://mbistaffing.com/interview-thank-you"
}A unique invitation url code is created from the above POST and is e retrieved using HTTP response headers for candidate interview URL with the X-HvApi-Interview-Code parameter.
This code then is pushed back to the candidate profile in Zoho Recruit as a custom field link.
https://mbistaffing.hirevue.com/interviews/[code]/
Twice daily at 7am and 2pm retrieve all the candidates that have completed the interviews to push their changes back to Zoho
Fetch all HireVue interviews since last call that are "Complete". This status indicates that the interview is now ready to be evaluated by all the evaluators assigned to this interview.
GET /api/v1/interviews/?qf=[status:enum:complete][takenDate:after:2019-01-01]Once we have the id of the completed interview, a like can be created like this:
https://mbistaffing.hirevue.com/#/evaluator/?evi=[id]
This URL is pushed back to Zoho Recruit and saved to the candidate record.
At this point, a Zoho Recruit Workflow is triggered that changes the candidate status to "Video Evaluation Submitted". The Recruiter - Account Manager evaluates the candidate. Review/Evaluation can be done in Zoho or HireVue, we just need to determine which makes more sense for Recruiter - Account Manager.
- If review is done in Zoho - A task will get created for the main Recruiter to review. If they like the candidate they change their status, to "Approved by Recruiter". This will trigger a Workflow that will email "Recruiting Evaluators" listed for the job. The evaluator has 24 hours to review the candidate(s) and determine if they want to schedule an interview. This status is sent back to Zoho which updates the candidates status as either "Video Evaluation Approved for Interview" or "Video Evaluation Rejected for Interview". If approved, the candidate will receive an email letting them know. If the Interviewer is connected to the Hirevue Scheduling Platform then a link will be included in the email asking them to schedule a time otherwise the MBI scheduler will reach out to schedule a time. The Recruiter - Account Manager also gets a task assigned to follow up on this and reach out to the candidate by phone within 24 hours. If rejected, the Recruiter - Account Manager is assigned a task to call the candidate and let them know. If it's noted that the candidate just wasn't a good fit for this role, they are asked on the call if they'd like to be considered for future/other roles.
- If done in HireVue - TBD