The Recent Interview Warning setting alerts your team when a candidate is being invited to an interview they have already completed within the last 6 months. The check applies to identical interview types — meaning the same role, or any role in your organization that shares the same interview archetype.
When enabled, this setting applies to all groups in your organization.
Who can enable this setting?
This setting is available to Organization Admins only. You can find it in:
Settings → Candidate Messaging → Recent Interview Warning
Toggle the switch to enable or disable the warning for your organization.
How it works
When a recruiter submits a candidate invitation, Karat checks whether that candidate has a completed an interview for the same role or same interview archetype within the past 6 months.
If a match is found, the behavior depends on how the invitation was submitted:
Karat Portal (single invite or bulk CSV)
Single invite
- The invite is paused and a warning is displayed showing the date the candidate last completed the interview.
- Recruiters (client users who are not vendors) see: the warning date and candidacy counts (this role vs. all roles), and a link to review the most recent interview for that candidate.
- Vendors see the warning and candidacy counts but do not see the link to the specific interview or candidacy (to protect client data).
- The recruiter can choose to proceed with the invite (confirming they want to re-invite) or cancel.
Bulk CSV upload
- Candidates flagged as recently interviewed are separated into a "Recently Interviewed" section on the results screen.
- Each flagged candidate shows the warning date and a confirmation prompt: "Are you sure you want to make the invite?"
- The recruiter can choose to proceed for each flagged candidate individually, or cancel.
- If all flagged candidates are confirmed, their status updates to Sent.
API (direct GraphQL API calls)
When a candidate invite is submitted via the Karat API and the organization has this setting enabled:
- The API returns an error: "This candidate completed an identical interview within the last 6 months ([date], ID: [interview_id]). Please proceed with this invitation in your Karat Portal."
- The invite is not created automatically.
- To proceed, the recruiter should log into the Karat Portal and re-submit the invite there, where they can review the warning and confirm.
- Alternatively, API callers can pass confirmRecentInterviewWarning: true in the mutation to explicitly bypass the warning and force the invite through programmatically.
ATS integration (polling-based)
When invites are triggered automatically through an ATS integration (e.g., Greenhouse, Lever):
- The invite is blocked and an error is returned (including the prior interview date and interview ID).
- Karat posts the full warning details back to the ATS, including the most recent interview date, interview ID, and a link to the interview result — the same content shown to recruiters in the Portal.
- The error message directs the team to proceed via the Karat Portal if they still want to re-invite the candidate.
- Because ATS polling invites are automated, the recruiter will need to manually go to the Portal to review and confirm the re-invite for the flagged candidate.
Notes
- The warning is informational — it does not permanently block re-inviting a candidate. It is designed to prompt intentional review before proceeding.
- The setting applies organization-wide and cannot be configured per group.
- Vendors submitting invites through the Portal see the warning and candidacy counts but do not see links to the specific interview or candidacy.