---
title: "Create Calendar Event"
method: POST
path: "/calendar/events"
tags: ["Calendar"]
---

# Create Calendar Event

`POST /calendar/events`

Create a new calendar event.

## Headers

- `authorization` string, nullable

## Request body

- CalendarEventCreatePayload — Request to create a calendar event.
  - `subject` string, required — Event subject
  - `description` string, nullable — Event description
  - `start_time` string, date-time, required — Event start time
  - `end_time` string, date-time, required — Event end time
  - `conference_url` string, required — Conference URL

## Response `201`

Successful Response

- CalendarEventResult — Calendar event DTO.
  - `id` string, uuid, required — Event ID
  - `subject` string, required — Event subject
  - `start_time` string, date-time, required — Event start time
  - `end_time` string, date-time, required — Event end time
  - `description` string, nullable — Event description
  - `location` string, nullable — Event location
  - `conference_url` string, nullable — Conference URL
  - `conference_provider` 'zoom' | 'teams' | 'meet' | 'other' | 'none' — Conference provider types.
  - `language` string, nullable — Language of the event
  - `attendees` object[] — List of attendees
  - `intelligence` CallIntelligenceResult — DTO for call intelligence.
    - `call_objective` string, nullable — Call objective
    - `call_goal` 'DISCOVERY' | 'DEMO' | 'NEGOTIATION' | 'CLOSING' | 'QBR' | 'SUPPORT' | 'ONBOARDING' | 'INTERNAL' | 'VC' | 'PRODUCT_RESEARCH' | 'OTHER' — Call goal types.
    - `goal_confidence_score` number, nullable — Confidence score for goal classification
    - `derived_from` 'AI_ANALYSIS' | 'USER_INPUT' | 'KEYWORD_MATCH' | 'UNKNOWN', required — Intelligence source types.
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
  - `call` CallResult
    - `call_id` string, uuid, required
    - `start_time` string, date-time, required
    - `end_time` string, date-time, nullable, required
    - `thumbnail` string, nullable, required
    - `recording` string, nullable, required
    - `duration` integer, nullable, required
    - `transcript` TranscriptCaption[], nullable, required
      - `speaker_name` string, required
      - `caption` string, required
      - `language` string, nullable, required
      - `start_time` number, nullable, required
      - `end_time` number, nullable, required
    - `title` string, nullable, required
    - `description` string, nullable, required
    - `summary` string, nullable, required
    - `coaching_summary` string, nullable, required
    - `language` string, nullable, required
  - `recall_bot_enabled` boolean, required — Whether the Recall bot is enabled for the event

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nomi/apis/fastapi.md) · [All operations](https://skmtc.dev/nomi/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nomi/fastapi/revisions/63a2f545499c/schema)