Create interview, using position data & candidate pre-screening

POST

/job-interview-create-for-candidate-with-token

This endpoint will receive candidate data, position information, will generate the interview. These are the steps taken by the endpoint

Generate interview for specific position

Generate token for the candidate to take the interview

Some or all fields below could be provided (that would make the interview questions more relevant) or if they are not provided, we will generate them using our LLM.

description

description_long

candidate_expectations

Note: Interviews are only created if one with the same position_name does not already exist. If an interview already exists, the candidate will receive a link to the existing interview.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://cool.jobmojito.com/functions/v1/job-interview-create-for-candidate-with-token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "position_name": "executive senior project manager",
    "position_location": "remote",
    "candidate_name": "John 2",
    "candidate_email": "john@email.com",
    "mojito_language_code": "en",
    "location": "remote",
    "candidate_resume": "I was working as a cleaner in multiple establishments like hotels, restaurants",
    "position_country_code": "sk",
    "candidate_country_code": "sk"
}'

Response Example

200 - Example 1

{
    "status": "ai_accept",
    "position_def_set_id": "40fc74dd-db38-47cb-9c6b-d2c631a697f8",
    "interview_def_set_id": "44c18c93-d7fe-4bb0-9f50-e4958179f2e9",
    "profile_interview_id": "8267200c-3a48-49f3-9559-b0178ddb8a5c",
    "interview_url": "https://..."
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠422Invalid input

🔴500Server error

Modified at 2025-07-15 07:12:15

Create interview, using position data

Create interview, using provided questions