How Recruit uses your calendar for interview availability and bookings
How Recruit reads your busy times to offer interview slots, and what it writes to your calendar when a candidate books.
How Recruit reads your busy times to offer interview slots, and what it writes to your calendar when a candidate books.
This is for interviewers and the people who build interview events. It assumes you have connected a calendar, as described in Connecting your calendar. You do not need to do anything here, but it explains why a slot is or is not offered and what appears in your diary.
How your availability is read
Recruit asks Google or Outlook when you are busy. For Google that is your main calendar. For Outlook it is your default calendar, and anything not marked as free counts as busy, including tentative meetings. Only the start and end times are used.
For a calendar-availability event, a time is offered to a candidate only if it sits inside the weekly schedule you set, is outside every blocked period, meets the minimum advance notice, and every host is free. Candidates see times over the coming seven days. Blocked periods are set on the event itself and apply to every host, so they are not read from anyone's calendar.
On a slot-based event, Recruit checks the primary interviewer's calendar against the slots that were added. A slot where that person is busy is not offered.
Busy times are checked with a short delay, so a meeting you have just added can take a few minutes to block out a slot.
How bookings are written to your calendar
When a candidate books an interview with the format set to Online, Recruit creates an event on the host's calendar and adds a Google Meet link (Google) or a Microsoft Teams link (Outlook). The primary interviewer's calendar is used first. If that person has no connected calendar, Recruit uses the first connected calendar among the other hosts and interviewers on the event. In-person events are not added to your calendar by Recruit.
The other interviewers are added as attendees. If the event is marked Private event, the calendar entry is private too. On Google the candidate is added as a guest without Google sending them its own invite. On Outlook the candidate is not added. Either way, the candidate receives Recruit's confirmation email, which carries the meeting link and one calendar invitation.
Each interviewer who receives the "Interview booked" email also gets a calendar invitation with it. It shows the candidate's name, or only their reference where identities are still hidden.
Cancelling or rescheduling a booking, and closing or deleting a static event, removes the calendar event again. If the calendar event could not be created, the booking still goes ahead, but it has no meeting link.
What candidates see when nothing can be offered
Slot-based booking pages show a message when there is nothing to pick. Each ends by asking the candidate to contact the recruiter.
- No Times Available: "The interviewer is not available at any of the offered times." The primary interviewer's connected calendar is busy at every offered time.
- No Upcoming Times: "All the offered interview times have passed."
- Fully Booked: "All available interview slots have been booked." It appears only when bookings really took the slots.
When more than one applies, Recruit shows No Upcoming Times first, then No Times Available, then Fully Booked. For connection problems and the other messages candidates can see, see Fixing calendar connection problems.