Skip to main content
POST
Register users for an interview

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Body

application/json
users
object[]
required

Candidates to register for the interview. Each gets a one-time interview URL.

Example:
interview_id
string<uuid>
required

Interview definition (interview_def_set) or position (position_def_set) id to register users for.

Minimum string length: 1
Example:

"04e09fa5-3fb8-4236-b37d-fca2bcd1cb66"

merchant_id
string<uuid> | null

Merchant id. Required when authenticating with the service key; for user tokens it is optional and only honored for admin / sub-merchant accounts.

Example:

"b5201178-46dd-4a20-a1af-7ffd647f834b"

hide_menu

When true (or the string "true"), the interview UI hides its menu (view_hm).

hide_iframe

When true (or the string "true"), the interview UI hides its iframe chrome (view_hi).

is_test

When true (or the string "true"), mints a test token that can take a draft/unpublished interview and flags the result as a test. For a DRAFT interview it also recompiles the definition (interview_recalc_definition) first, so the test session includes the current questions/welcome. This makes it a single-call "trigger interview test".

Response

Per-user registration results.

name
string | null
email
string
external_id
string | null
phone
string | null
linked_in
string | null

Echo of the LinkedIn URL sent for this user.

tags
string[] | null

Echo of the tag ids sent for this user.

custom_fields
object | null

Echo of the custom fields sent for this user.

profile_interview_id
string

The candidate registered (profile_interview.id; for a company on a shared candidate pool, the candidate in the parent company). Present once the candidate was found or created, also when a later step of this user failed.

result
string

"ok" on success, otherwise an "Error: ..." message for that user.

Example:

"ok"

interview_url
string

One-time interview URL containing the minted interview_token. Present only on success.

{key}
unknown