---
title: "Creates a timeslot"
method: POST
path: "/interviews/{interviewId}/timeslots"
tags: ["timeslots"]
---

# Creates a timeslot

`POST /interviews/{interviewId}/timeslots`

Supported only for interviews created via the Public API.

## Path parameters

- `interviewId` string, uuid, required

## Request body

- Timeslot
  - `id` string, guid
  - `interviewType` string
  - `title` string
  - `place` string
  - `startsOn` string, date-time, required
  - `endsOn` string, date-time, required
  - `interviewers` Interviewer[], required
    - `id` string, required
    - `status` 'accepted' | 'declined' | 'pending' | 'tentative', required
  - `candidateStatus` 'accepted' | 'declined' | 'pending' | 'tentative'
  - `noShow` boolean

## Response `201`

Created timeslot with id

## Other responses

- `403` — Forbidden to create a timeslot
- `404` — with codes: * **INTERVIEW_NOT_FOUND** when no interview with given id
- `409` — with codes: * **CANNOT_ADD_MORE_TIMESLOTS** when interview already contains maximum number of timeslots
- `422` — When input validation fails or with codes: * **INACTIVE_OR_DELETED_INTERVIEWERS** when at least one of the interviewers is inactive or deleted * **END_DATE_BEFORE_START_DATE** when end date of the timeslot is before start date * **NON_EXISTING_INTERVIEWERS** when at least one of the interviewers does not exist
- `500` — Unexpected error

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/versions/449bdc2516c9/schema)