Skip to main content

interviews.create

Schedule an interview on an application

Request
POST/api/v1/applications/{applicationId}/interviews
Scope required
interviews:write
Effect
Changes data. Send an Idempotency-Key if you might retry it.
Acts on
Acts on the account’s own job search.
MCP tool
interviews_create
Environment
Live and sandbox alike.
Request body
JSON.

What it does

Records an interview against a card the account owns and answers 201 with it. Every field but the application is optional: an interview with no `time` is stamped with now, and one with no `type` is recorded as `other`. Scheduling an interview does not move the card — call `applications.move` with `interviewing` if the column should change too. An application belonging to another account answers 404, never 403. Send an `Idempotency-Key` header if a retry must not schedule it twice.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
NameSent inRequirementAccepts
applicationIdpathRequiredstring

Request body

feedback
string or null, optional
location
string or null, optional
notes
string or null, optional
time
string or null, optional
type
one of: phone_screen, technical, behavioral, panel, take_home, video_call, in_person, other or null, optional

Response

applicationId
string, required
createdAt
string, required
feedback
string or null, required
id
string, required
location
string or null, required
notes
string or null, required
time
string or null, required
type
one of: phone_screen, technical, behavioral, panel, take_home, video_call, in_person, other or null, required
updatedAt
string, required

Examples

Book a technical screen

Book a technical screen — request
curl -s -X POST https://www.jobapplicationtracking.com/api/v1/applications/app_123/interviews \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "time": "2026-02-20T15:00:00.000Z",
  "type": "technical",
  "location": "Zoom"
}'
Book a technical screen — response
{
  "id": "iv_42",
  "applicationId": "app_123",
  "time": "2026-02-20T15:00:00.000Z",
  "type": "technical",
  "location": "Zoom",
  "notes": "Two hours, systems design.",
  "feedback": null,
  "createdAt": "2026-02-11T17:05:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}

Related operations