put

Endpoint for scheduling interviews for candidates. This endpoint allows the creation of interview appointments for a specific applicant for a specific job.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The application form ID corresponding to a job application in the Apploi platform. The application form ID is a unique identifier for the job application in the Apploi platform. The application form ID can be found in the 'id' field of the each of the items in the response body of a call to the /applicants endpoint in the Apploi Partner API.

Examples: 265733753, 265733754, etc.

Body Params

Pass in a JSON body with interview details. Either interviewerId must be provided, or both interviewerTeamId and interviewerEmail must be provided.

Option 1: Using interviewerId

    {
        "date": "2022-12-05T17:30:00Z",
        "duration": "60",
        "timezone": "America/New_York",
        "location": "Virtual",
        "interviewerId": "123456"
    }
    

Option 2: Using interviewerTeamId and interviewerEmail

    {
        "date": "2022-12-05T17:30:00Z",
        "duration": "60",
        "timezone": "America/New_York",
        "location": "Virtual",
        "interviewerEmail": "[email protected]",
        "interviewerTeamId": "23567"
    }
    
date-time
required

Interview date and time, specified in ISO 8601 format. Non-ISO 8601 format date-time strings are not allowed. The timezone information provided in this value will be overridden by the value provided in the timezone field. However, this field still requires timezone information to be present, so simply appending Z at the end of the date-time string is sufficient.

Examples: "2021-03-25T10:00:00Z", "2024-10-22T14:00:00Z", etc.

string
required
Defaults to 60

The interview duration in minutes. The type of this field is a numeric integer string. Non-numeric string characters are not allowed.

Examples: "30", "60", "90", etc.

string
Defaults to [email protected]

The email address of the interviewer in the Apploi platform. This field is only required when the interviewerId is not available. This must be a valid email address string of a team member recorded in the Apploi platform.

Examples: "[email protected]", "[email protected]", etc.

string
Defaults to 123456

The User ID of the interviewer in the Apploi platform. This field must be an integer string value. Non-integer string characters are not allowed. This is the user ID of a team member recorded in the Apploi platform. Reaching out to the Apploi support team may be the best way to get the correct user ID for the interviewer.

Examples: "123456", "789012", etc.

string
Defaults to 345678

The Team ID of the interviewer in the Apploi platform. This field is only required when the interviewerId is not available. This field must be an integer string value. Non-integer string characters are not allowed. This is the team ID of a team member recorded in the Apploi platform. Reaching out to the Apploi support team may be the best way to get the correct team ID for the interviewer.

Examples: "345678", "987898", etc.

string
Defaults to Virtual

The location of the interview. The only restriction on this field is that it must be a string. This allows for specifying a physical location, a virtual location, or any other type of location.

Examples: "123 Main St, New York, NY 10001", "Virtual", "https://meet.google.com/abc-123-xyz", etc.

string
required
Defaults to America/New_York

The timezone of the interview date and time. The timezone must be a valid timezone string as defined by the IANA Time Zone Database. This timezone will override any timezone information specified in the date field.

Examples: "America/New_York", "Europe/London", "Asia/Tokyo", etc.

Headers
string
required
string
Responses

403

Invalid Token

404

Not Found

405

405 response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json