---
title: "Create a new coach huddle event"
method: POST
path: "/cohorts/{cohortId}/events/huddle"
tags: ["Cohort Events"]
---

# Create a new coach huddle event

`POST /cohorts/{cohortId}/events/huddle`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{cohortId}/events/huddle`
- Auth: none declared

Creates a new coach huddle in the cohort_events table and updates the cohort's coach_huddle_dates array. The huddle can optionally have a scheduled date/time.

## Path parameters

- `cohortId` string, uuid, required

## Request body

- object
  - `scheduled_start` string, date-time, nullable: Optional date/time for the huddle (ISO 8601)

## Response `201`

Coach huddle created successfully

- CohortEvent
  - `id` string, uuid
  - `cohort_id` string, uuid
  - `event_type` 'coach_immersion' | 'participant_orientation' | 'coach_huddle' | 'cohort_wrap_up'
  - `event_name` string
  - `event_number` integer
  - `scheduled_start` string, date-time, nullable
  - `scheduled_end` string, date-time, nullable
  - `timezone` string
  - `video_link` string, nullable
  - `status` 'not_scheduled' | 'ready' | 'scheduled' | 'awaiting_attendance' | 'completed'
  - `invites_sent_at` string, date-time, nullable
  - `attendance_marked` boolean

## Other responses

- `401`: Unauthorized
- `404`: Cohort not found
- `500`: Internal server error

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)