---
title: "Create a new cohort"
method: POST
path: "/api/cohorts"
tags: ["Cohorts"]
---

# Create a new cohort

`POST /api/cohorts`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/cohorts`
- Auth: none declared

Creates a cohort with program, modalities, sessions, and configuration

## Request body

- object
  - `partner_id` string, uuid, required
  - `name` string, required
  - `disabled_email_recipients` string[]: Recipient types with disabled automated emails

## Response `201`

Cohort created successfully

## Other responses

- `400`: Invalid request
- `409`: Cohort code or name already exists

---

[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)