---
title: "Create Interviews"
method: POST
path: "/ats/interviews"
tags: ["ats/interviews"]
---

# Create Interviews

`POST /ats/interviews`

Create Interviews in any supported Ats software

## Query parameters

- `remote_data` boolean

## Headers

- `x-connection-token` string, required

## Request body

- UnifiedAtsInterviewInput
  - `status` 'SCHEDULED' | 'AWAITING_FEEDBACK' | 'COMPLETED', nullable — The status of the interview
  - `application_id` string, nullable — The UUID of the application
  - `job_interview_stage_id` string, nullable — The UUID of the job interview stage
  - `organized_by` string, nullable — The UUID of the organizer
  - `interviewers` string[], nullable — The UUIDs of the interviewers
  - `location` string, nullable — The location of the interview
  - `start_at` string, date-time, nullable — The start date and time of the interview
  - `end_at` string, date-time, nullable — The end date and time of the interview
  - `remote_created_at` string, date-time, nullable — The remote creation date of the interview
  - `remote_updated_at` string, date-time, nullable — The remote modification date of the interview
  - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora

## Response `201`

- UnifiedAtsInterviewOutput
  - `status` 'SCHEDULED' | 'AWAITING_FEEDBACK' | 'COMPLETED', nullable — The status of the interview
  - `application_id` string, nullable — The UUID of the application
  - `job_interview_stage_id` string, nullable — The UUID of the job interview stage
  - `organized_by` string, nullable — The UUID of the organizer
  - `interviewers` string[], nullable — The UUIDs of the interviewers
  - `location` string, nullable — The location of the interview
  - `start_at` string, date-time, nullable — The start date and time of the interview
  - `end_at` string, date-time, nullable — The end date and time of the interview
  - `remote_created_at` string, date-time, nullable — The remote creation date of the interview
  - `remote_updated_at` string, date-time, nullable — The remote modification date of the interview
  - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora
  - `id` string, nullable — The UUID of the interview
  - `remote_id` string, nullable — The remote ID of the interview in the context of the 3rd Party
  - `remote_data` object, nullable — The remote data of the interview in the context of the 3rd Party
  - `created_at` string, date-time, nullable — The created date of the object
  - `modified_at` string, date-time, nullable — The modified date of the object

## Changes

- **2024-08-05** `ca0fa45ebd05` — 1 breaking, 3 warning, 3 info
  - request property `status` was restricted to a list of enum values
  - added the new `AWAITING_FEEDBACK` enum value to the `status` response property for the response status `201`
  - added the new `COMPLETED` enum value to the `status` response property for the response status `201`
  - added the new `SCHEDULED` enum value to the `status` response property for the response status `201`
  - …3 more
- **2024-08-05** `ca213ae36b7f` — 22 breaking, 13 info
  - the response property `application_id` became nullable for the status `201`
  - the response property `created_at` became nullable for the status `201`
  - the response property `end_at` became nullable for the status `201`
  - the response property `field_mappings` became nullable for the status `201`
  - …31 more
- **2024-08-05** `167edd5346ec` — 14 breaking, 5 info
  - the request property `application_id` became not nullable
  - the request property `end_at` became not nullable
  - the request property `field_mappings` became not nullable
  - the request property `interviewers` became not nullable
  - …15 more
- …earlier changes not shown

[Full history](https://skmtc.dev/panoratech/apis/panora-api-2/changes/ats/interviews/post.md)

---

[API](https://skmtc.dev/panoratech/apis/panora-api-2.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panoratech/panora-api-2/revisions/ca0fa45ebd05/schema)