---
title: "POST /api/public/meetings"
method: POST
path: "/api/public/meetings"
tags: ["Meetings"]
---

# POST /api/public/meetings

`POST /api/public/meetings`

Schedule a meeting. "type" is the location (Online or In person). "meetingType" is the format (Individual or Group).

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `title` string, required
  - `startDate` string, required — ISO date-time
  - `endDate` string, required — ISO date-time
  - `duration` number — Minutes (optional)
  - `type` 'Online' | 'In person', required
  - `meetingType` 'Individual' | 'Group'
  - `onlineLink` string — Zoom/Meet URL
  - `address` string — Physical address
  - `notes` string
  - `trainees` string[] — Array of trainee ids
  - `capacity` number — For group meetings

## Response `201`

Created

- object — Created
  - `data` object
    - `id` string
    - `coach` string
    - `title` string
    - `startDate` string, date-time
    - `endDate` string, date-time
    - `duration` number
    - `type` 'Online' | 'In person'
    - `meetingType` 'Individual' | 'Group'
    - `onlineLink` string
    - `address` string
    - `notes` string
    - `status` string
    - `capacity` number
    - `trainees` object[] — Meeting attendees. email and phoneNumber are returned only when the key also has the trainees:read scope.
      - `id` string
      - `name` string
      - `email` string
      - `phoneNumber` string
    - `createdAt` string, date-time
  - `warnings` object[] — Non-fatal problems with follow-up writes. The resource was created, but each listed field was not applied.
    - `field` string
    - `message` string

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `429` — Default Response
- `500` — Default Response

---

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