Skip to main content

When to use this

Hireflix supports two main ways to invite candidates to interviews:
  • Individual invitations — where each candidate gets a unique, personal interview link.
  • Public links — where everyone uses the same link to access the interview.
This feature applies to public links. Usually, candidates opening a public link must manually enter their name, email, and other details before starting the interview. However, if you already have this information (for example, collected through your own form or onboarding flow), you can pass it directly through URL parameters. This saves candidates time, avoids input errors, and lets you seamlessly hand them off from your system or form to the Hireflix interview screen without requiring them to re-enter their details.

How to use this

When you use the “inviting a candidate” mutation, Hireflix returns two URLs: a short and a public one. For example:
https://app.hireflix.com/31dah1DX
If you want to embed the interview in your own app or prefill candidate details automatically, you can transform this into a public-application URL like so:
https://app.hireflix.com/public-application/68b43e38b19cf131a17c543f?firstName=Michiel
Here’s what changed:
  1. The URL path now includes /public-application/ instead of the short link.
  2. You use the long-form interview ID (returned when you invite a candidate or list interviews).
  3. A query parameter (?firstName=Michiel) automatically fills the candidate’s first name field.
The result opens the interview welcome screen with the provided candidate name already filled in. Interviewembeddedparameters Pn

Supported parameters

You can pass the following fields as query parameters to prefill the interview form:
ParameterDescription
firstNameCandidate’s first name
lastNameCandidate’s last name
emailCandidate’s email address
phoneNumberCandidate’s phone number (must include the country code and use %2B instead of +). A Belgian phone number +32 491 50 50 50 becomes %2B32491505050.

Full Example