---
title: "Create Calendar Slots"
method: POST
path: "/v2/available_slots"
tags: ["Calendar Slots"]
---

# Create Calendar Slots

`POST /v2/available_slots`

Create a new available slot

## Request body

- object
  - `recruiter_email` string, required — Email address of the recruiter
  - `start_time` string, required — Start time of the appointment slot
  - `end_time` string, required — End time of the appointment slot
  - `location` string — Location of the appointment slot
  - `max_attendees` integer, required — Maximum number of attendees, must be greater than 0
  - `instructions` string — Instructions for attendees
  - `frequency` integer — Number of days or weeks to repeat the slot
  - `split` integer — Number of minutes to split each session into
  - `period` 'days' | 'weeks' | 'weekdays' — Time period to repeat the slot
  - `title` string — Name of the event
  - `stage_ids` string[]
  - `opening_stage_ids` object[] — Identifiers for stage and opening pairs, used for workflow enabled stages. Will fail if stage is not associated with the opening
    - `funnel_id` string — Identifier for opening
    - `stage_id` string — Identifier for stage
  - `adaptive` boolean — removed if in conflict with booked session or external events

## Response `201`

OK

- AvailableSlot[]
  - `id` string, required — Unique identifier of the available slot
  - `start_time` string, datetime, required — Start time of the available slot
  - `end_time` string, datetime, required — End time of the available slot
  - `location` string, nullable — Location of the available slot
  - `recruiter` string — Name of recruiter for the available slot
  - `max_attendees` integer — Maximum number of attendees for the slot
  - `booked_slots_count` integer, required — Count of booked slots for the availble slot
  - `adaptive` boolean — Prevents conflict with bookings and external events

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/versions/5f406c0e9462/schema)