---
title: "Create a calendar event"
method: POST
path: "/calendars/{calendar}/events"
tags: ["Calendars"]
---

# Create a calendar event

`POST /calendars/{calendar}/events`

## Path parameters

- `calendar` integer, required

## Request body

- StoreCalendarEventRequest
  - `timeStart` string, date-time, required
  - `title` string, required
  - `description` string, nullable
  - `location` string, nullable
  - `contactName` string, nullable
  - `contactEmail` string, email, nullable
  - `contactPhoneNumber` string, nullable
  - `contactId` string, uuid, nullable
  - `callId` integer, nullable

## Response `201`

Event created

- CalendarEventResource
  - `id` integer
  - `calendarId` integer
  - `title` string
  - `description` string, nullable
  - `location` string, nullable
  - `timeStart` string, date-time
  - `timeEnd` string, date-time
  - `duration` integer
  - `contactName` string, nullable
  - `contactEmail` string, nullable
  - `contactPhoneNumber` string, nullable
  - `contact` object, nullable
  - `call` object, nullable
  - `createdBy` object, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable

## Other responses

- `422` — Slot not available

---

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