---
title: "Create a meeting"
method: POST
path: "/v1/meetings"
tags: ["Meetings"]
---

# Create a meeting

`POST /v1/meetings`

Create a new meeting. Only past meetings can be logged via the API.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `book_id` string, required — The book ID
  - `title` string, required — Meeting title
  - `start_time` string, date-time, required — Meeting start time (ISO8601). Must be in the past.
  - `end_time` string, date-time — Meeting end time (ISO8601)
  - `notepad` string — Meeting notes (markdown)
  - `household_ids` string[] — Array of household IDs to link to this meeting

## Response `201`

meeting created

- object
  - `id` string, required
  - `title` string, required
  - `start_time` string, date-time, nullable
  - `end_time` string, date-time, nullable
  - `duration_seconds` integer
  - `meeting_link` string, nullable
  - `meeting_source` 'instant' | 'calendar_event' | 'imported' | 'logged', nullable
  - `meeting_type` string
  - `book_id` string, required
  - `households` object[], required
    - `id` string
    - `name` string
  - `users` object[]
    - `id` string
    - `email` string
    - `first_name` string, nullable
    - `last_name` string, nullable
  - `has_transcript` boolean, required
  - `has_recordings` boolean, required
  - `quick_summary` string, nullable
  - `ai_summary` string, nullable
  - `notepad` string, nullable
  - `transcript` unknown[], nullable
    - unknown
  - `event_participants` unknown[], nullable
    - unknown
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400` — bad request - invalid JSON
- `401` — unauthorized - missing or invalid token
- `403` — forbidden
- `422` — unprocessable entity - invalid payload

---

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